@house-of-angular/typed-urls

TypedUrls

A utility package for creating typed url addresses.

Installation

npm install @house-of-angular/typed-urls --save-dev

Features

• Supports route urls
• Supports query parameters
• Allows to specify the type of the query parameters
• Allows marking query parameters as required/optional

Usage

You can create an instance of typed url with urlFactory. Url factory will return an instance of class with url method that allows you to create an url based on provided blueprint.

import { urlFactory } from '@house-of-angular/typed-urls';

const url = urlFactory('http://api-domain/users');

// Logs "http://api-domain/users"
console.log(url.url());

Route Parameters

Based on provided value urlFactory will indicate whether any params in the url are expected. It will throw an error in case they are.

Example:

import { urlFactory } from '@house-of-angular/typed-urls';

const url = urlFactory('http://api-domain/users/:id');

// Logs "http://api-domain/users/1234"
console.log(url.url({ id: '1234' }));


const multipleParamsUrl = urlFactory('http://api-domain/users/:id/achievements/:achievementId');

// Logs "http://api-domain/users/1234/achievements/533"
console.log(multipleParamsUrl.url({ id: '1234', achievementId: '533' }));

Query Parameters

Url factory automatically retrieves expected query parameters from the url. The value of the parameter should be set to its type.

List of Available Types:

• string
• number
• boolean
• array<type> (e.g. array<string>, array<array<number>>)
• object
• any

Example:

import { urlFactory } from '@house-of-angular/typed-urls';

const url = urlFactory('http://api-domain/products?limit=number&sorting=string');

// Logs "http://api-domain/products?limit=5&sorting=asc"
console.log(url.url({ limit: 5, sorting: 'asc' }));

All query parameters are optional by default. To mark param as required add an exclamation mark after parameter type.

Example:

const url = urlFactory('http://api-domain/products?limit=number&sorting=string!')

In the example above:

• limit parameter is optional
• sorting parameter is required

Combination of Parameters

Library allows combination of both parameter types in single url.

Example:

import { urlFactory } from '@house-of-angular/typed-urls';

const url = urlFactory('http://api-domain/users/:id/achievements?limit=number&sorting=string');

// Logs "http://api-domain/users/1/achievements?limit=5&sorting=asc"
console.log(url.url({ id: 1 }, { limit: 5, sorting: 'asc' }));

Changelog

18.0.0 (2024-06-25)

Build System / Dependencies

• update versions and pnpm lock (#48) (b64d84ca)
• preinstall script for forbidding usage different package manage (d8810523)
• update angular to 16 (8104bd82)
• commit-lint: fix building commit-lint (c5134cfd)

Chores

• release:
  • 17.0.5 (e20eb76a)
  • 17.0.4 (d68e5597)
  • 17.0.3 (bd9b52b8)
  • 17.0.2 (11323a90)
  • 17.0.1 (73aac9e8)
  • 17.0.0 (1987d258)
  • 16.0.0 (a4bf8748)
  • 15.0.1 (ae9150b6)
  • 15.0.0 (f990be2c)
• typed-urls:
  • add repo information to project file (16de03b5)
  • include readme and license file in built libraries (d1adf994)

Documentation Changes

• add information about (2f9d4964)
• add versions with links in readme (d4a1a075)
• create readme files (7ab3fa02)
• validation-messages:
  • remove typo (0486d0f1)
  • update readme (f3fa2610)

New Features

• workspace: update workspace to v18 (6fe2231b)
• typed-urls:
  • update peer deps (f5970123)
  • typed-urls migration (d938a953)
• validation-messages:
  • new builder (c34725dc)
  • update example app (f16351f4)
  • add support for specifying validation messages locally (7072219c)
  • read from control from host component (1fb418ec)
  • add ApiErrorMessages type and ad matInputControl getters (38bc702c)
  • add support for controlName input (8e42d761)
  • support multiple interpolate parameters (e2954419)
  • angular material config (9c015d94)
  • example app config (3603f156)
  • validation messages lib migration (b2b51134)
• fix package.json (b6dd5ec2)
• fix package.json (#42) (25171780)
• fix lint (82de64a7)
• fix tests, bug with defining error messages + update more packages (bb0de65a)
• fix ci (762179f7)
• update workspace to v17 (66a9f65b)
• add possibility to update package in publish packages workflow (d1732a19)
• add github action for publishing to npm (22154d56)
• create example application for typed urls (7583a278)
• add script for publishing latest, built packages (ee7987e0)
• hoa: auto-generate changelog on update libs versions (ffb21595)
• ng-forms: allow to use plain string value for patter error message (fc120e26)
• packages:
  • resolve peer dependencies conflicts (abb14cc0)
  • ci setup (c0dc830b)
• validation-message: onpush change detection strategy (26f7faf5)
• commit-lint: create commit lint lib and move from "dev" repository (ddff8d85)
• linking-tool: linking-tool migration & validation-messages lib config (45703d23)
• config:
  • standard version (14c11554)
  • hasky commit lint (5e5196a2)

Bug Fixes

• update publish packages pnpm version (d1f6b8a2)
• update prettier and fix config path (#46) (223e1e67)
• fix types of form (269e7ac0)
• fix publish packages.yml misspell (37bd0e26)
• fix import and publish command (1702d037)
• commit-lint:
  • peer dependencies (24dcb0f7)
  • make control container optional (f1f60e14)
• validation-messages:
  • add optional decorator to MatFormField dependency (58b27f46)
  • update control input type to AbstractControl (53c032ac)
  • export utils from library, add merge config messages util to index.ts (4670f1a9)
  • mark component for check after updating the messages (510645bb)
  • remove white space between error and input caused by block elements (8cdec93e)
  • execute cdr#markForCheck on valueChanges (cbdc42e4)
• typed-urls: Fix bug where passing urls with multiple params resulted in Record<string, string> type (3fce4c8a)

Other Changes

• add script for updating packages' versions (9ea38e0e)

Refactors

• validation-messages:
  • refactor code using signals (11ed7215)
  • implement review suggestions in validation-messages.component.ts (22479005)
  • rename validationMessages input to errorMessages (8adc7f1d)
• change npm to pnpm commands in publish packages action (5cc611ed)

Code Style Changes

• validation-messages: format code with prettier, remove commented code related to memoization (7506d49c)

Tests

• validation-messages: fix validation-messages unit test (a10cabdf)