@atscript/db-client 0.1.59 → 0.1.60

package/dist/index.cjs

@@ -350,13 +350,34 @@ var Client = class {
 	}
 };
 /**
-* Encode a row identifier for substitution into a `processor: 'navigate'` URL template.
-* The values are URL-encoded and joined with `/` in `meta.preferredId` field
-* declaration order — NOT in object-key insertion order (which is unstable
-* across callers).
+* Render a single identifier field for substitution into a navigate-URL
+* template or human-readable string. `null` / `undefined` collapse to `""`
+* (NOT the literal `"undefined"` / `"null"` that `String()` would produce).
+*/
+function formatIdentifierField(v) {
+	if (v === null || v === void 0) return "";
+	if (typeof v === "string") return v;
+	if (typeof v === "number" || typeof v === "boolean" || typeof v === "bigint") return String(v);
+	return JSON.stringify(v);
+}
+/**
+* Render a row identifier as a `/`-joined string in `preferredId`
+* declaration order — NOT object-key insertion order (which is unstable
+* across callers). Raw form, no URL-encoding; for prompt text, error
+* messages, log lines, etc.
+*/
+function formatIdentifier(id, preferredId) {
+	if (id === void 0) return "";
+	return preferredId.map((f) => formatIdentifierField(id[f])).join("/");
+}
+/**
+* URL-encoded form of `formatIdentifier` — for `processor: 'navigate'`
+* `$1` substitution. Each field is `encodeURIComponent`'d, then joined
+* with a literal `/`. Missing fields render as empty segments (e.g.
+* `acme//jane`), not the literal `"undefined"`.
 */
 function encodeNavigateId(id, preferredId) {
-	return preferredId.map((f) => encodeURIComponent(String(id[f]))).join("/");
+	return preferredId.map((f) => encodeURIComponent(formatIdentifierField(id[f]))).join("/");
 }
 function describeShape(value) {
 	if (value === null) return "null";
@@ -369,3 +390,6 @@ exports.ActionNotFoundError = ActionNotFoundError;
 exports.ActionUnsupportedError = ActionUnsupportedError;
 exports.Client = Client;
 exports.ClientError = ClientError;
+exports.encodeNavigateId = encodeNavigateId;
+exports.formatIdentifier = formatIdentifier;
+exports.formatIdentifierField = formatIdentifierField;

package/dist/index.d.cts

@@ -153,6 +153,26 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
   private _buildInit;
   private _send;
 }
+/**
+ * Render a single identifier field for substitution into a navigate-URL
+ * template or human-readable string. `null` / `undefined` collapse to `""`
+ * (NOT the literal `"undefined"` / `"null"` that `String()` would produce).
+ */
+declare function formatIdentifierField(v: unknown): string;
+/**
+ * Render a row identifier as a `/`-joined string in `preferredId`
+ * declaration order — NOT object-key insertion order (which is unstable
+ * across callers). Raw form, no URL-encoding; for prompt text, error
+ * messages, log lines, etc.
+ */
+declare function formatIdentifier(id: Record<string, unknown> | undefined, preferredId: readonly string[]): string;
+/**
+ * URL-encoded form of `formatIdentifier` — for `processor: 'navigate'`
+ * `$1` substitution. Each field is `encodeURIComponent`'d, then joined
+ * with a literal `/`. Missing fields render as empty segments (e.g.
+ * `acme//jane`), not the literal `"undefined"`.
+ */
+declare function encodeNavigateId(id: Record<string, unknown>, preferredId: readonly string[]): string;
 //#endregion
 //#region src/client-error.d.ts
 /**
@@ -225,4 +245,4 @@ declare class ActionUnsupportedError extends Error {
   constructor(action: string, processor: string, message: string);
 }
 //#endregion
-export { ActionDisabledError, type ActionDisabledErrorBody, ActionNotFoundError, ActionUnsupportedError, type AggregateQuery, type AggregateResult, type AtscriptClientShape, Client, ClientError, type ClientOptions, type ClientResponse, type ClientValidationError, type ClientValidator, type DataOf, type FieldMeta, type FilterExpr, type IdOf, type MetaResponse, type NavOf, type OwnOf, type PageResult, type RelationInfo, type SearchIndexInfo, type ServerError, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbDeleteResult, type TDbInsertManyResult, type TDbInsertResult, type TDbUpdateResult, type TSerializedAnnotatedType, type TypedWithRelation, type Uniquery, type UniqueryControls, type ValidatorMode };
+export { ActionDisabledError, type ActionDisabledErrorBody, ActionNotFoundError, ActionUnsupportedError, type AggregateQuery, type AggregateResult, type AtscriptClientShape, Client, ClientError, type ClientOptions, type ClientResponse, type ClientValidationError, type ClientValidator, type DataOf, type FieldMeta, type FilterExpr, type IdOf, type MetaResponse, type NavOf, type OwnOf, type PageResult, type RelationInfo, type SearchIndexInfo, type ServerError, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbDeleteResult, type TDbInsertManyResult, type TDbInsertResult, type TDbUpdateResult, type TSerializedAnnotatedType, type TypedWithRelation, type Uniquery, type UniqueryControls, type ValidatorMode, encodeNavigateId, formatIdentifier, formatIdentifierField };

package/dist/index.d.mts

@@ -153,6 +153,26 @@ declare class Client<T extends AtscriptClientShape = AtscriptClientShape> {
   private _buildInit;
   private _send;
 }
+/**
+ * Render a single identifier field for substitution into a navigate-URL
+ * template or human-readable string. `null` / `undefined` collapse to `""`
+ * (NOT the literal `"undefined"` / `"null"` that `String()` would produce).
+ */
+declare function formatIdentifierField(v: unknown): string;
+/**
+ * Render a row identifier as a `/`-joined string in `preferredId`
+ * declaration order — NOT object-key insertion order (which is unstable
+ * across callers). Raw form, no URL-encoding; for prompt text, error
+ * messages, log lines, etc.
+ */
+declare function formatIdentifier(id: Record<string, unknown> | undefined, preferredId: readonly string[]): string;
+/**
+ * URL-encoded form of `formatIdentifier` — for `processor: 'navigate'`
+ * `$1` substitution. Each field is `encodeURIComponent`'d, then joined
+ * with a literal `/`. Missing fields render as empty segments (e.g.
+ * `acme//jane`), not the literal `"undefined"`.
+ */
+declare function encodeNavigateId(id: Record<string, unknown>, preferredId: readonly string[]): string;
 //#endregion
 //#region src/client-error.d.ts
 /**
@@ -225,4 +245,4 @@ declare class ActionUnsupportedError extends Error {
   constructor(action: string, processor: string, message: string);
 }
 //#endregion
-export { ActionDisabledError, type ActionDisabledErrorBody, ActionNotFoundError, ActionUnsupportedError, type AggregateQuery, type AggregateResult, type AtscriptClientShape, Client, ClientError, type ClientOptions, type ClientResponse, type ClientValidationError, type ClientValidator, type DataOf, type FieldMeta, type FilterExpr, type IdOf, type MetaResponse, type NavOf, type OwnOf, type PageResult, type RelationInfo, type SearchIndexInfo, type ServerError, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbDeleteResult, type TDbInsertManyResult, type TDbInsertResult, type TDbUpdateResult, type TSerializedAnnotatedType, type TypedWithRelation, type Uniquery, type UniqueryControls, type ValidatorMode };
+export { ActionDisabledError, type ActionDisabledErrorBody, ActionNotFoundError, ActionUnsupportedError, type AggregateQuery, type AggregateResult, type AtscriptClientShape, Client, ClientError, type ClientOptions, type ClientResponse, type ClientValidationError, type ClientValidator, type DataOf, type FieldMeta, type FilterExpr, type IdOf, type MetaResponse, type NavOf, type OwnOf, type PageResult, type RelationInfo, type SearchIndexInfo, type ServerError, type TCrudOp, type TCrudPermissions, type TDbActionInfo, type TDbActionIntent, type TDbActionLevel, type TDbActionProcessor, type TDbDeleteResult, type TDbInsertManyResult, type TDbInsertResult, type TDbUpdateResult, type TSerializedAnnotatedType, type TypedWithRelation, type Uniquery, type UniqueryControls, type ValidatorMode, encodeNavigateId, formatIdentifier, formatIdentifierField };

package/dist/index.mjs

@@ -349,13 +349,34 @@ var Client = class {
 	}
 };
 /**
-* Encode a row identifier for substitution into a `processor: 'navigate'` URL template.
-* The values are URL-encoded and joined with `/` in `meta.preferredId` field
-* declaration order — NOT in object-key insertion order (which is unstable
-* across callers).
+* Render a single identifier field for substitution into a navigate-URL
+* template or human-readable string. `null` / `undefined` collapse to `""`
+* (NOT the literal `"undefined"` / `"null"` that `String()` would produce).
+*/
+function formatIdentifierField(v) {
+	if (v === null || v === void 0) return "";
+	if (typeof v === "string") return v;
+	if (typeof v === "number" || typeof v === "boolean" || typeof v === "bigint") return String(v);
+	return JSON.stringify(v);
+}
+/**
+* Render a row identifier as a `/`-joined string in `preferredId`
+* declaration order — NOT object-key insertion order (which is unstable
+* across callers). Raw form, no URL-encoding; for prompt text, error
+* messages, log lines, etc.
+*/
+function formatIdentifier(id, preferredId) {
+	if (id === void 0) return "";
+	return preferredId.map((f) => formatIdentifierField(id[f])).join("/");
+}
+/**
+* URL-encoded form of `formatIdentifier` — for `processor: 'navigate'`
+* `$1` substitution. Each field is `encodeURIComponent`'d, then joined
+* with a literal `/`. Missing fields render as empty segments (e.g.
+* `acme//jane`), not the literal `"undefined"`.
 */
 function encodeNavigateId(id, preferredId) {
-	return preferredId.map((f) => encodeURIComponent(String(id[f]))).join("/");
+	return preferredId.map((f) => encodeURIComponent(formatIdentifierField(id[f]))).join("/");
 }
 function describeShape(value) {
 	if (value === null) return "null";
@@ -363,4 +384,4 @@ function describeShape(value) {
 	return typeof value;
 }
 //#endregion
-export { ActionDisabledError, ActionNotFoundError, ActionUnsupportedError, Client, ClientError };
+export { ActionDisabledError, ActionNotFoundError, ActionUnsupportedError, Client, ClientError, encodeNavigateId, formatIdentifier, formatIdentifierField };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db-client",
-  "version": "0.1.59",
+  "version": "0.1.60",
   "description": "Browser-compatible HTTP client for @atscript/moost-db REST endpoints.",
   "keywords": [
     "atscript",
@@ -50,7 +50,7 @@
     "@atscript/typescript": "^0.1.50",
     "@uniqu/core": "^0.1.5",
     "unplugin-atscript": "^0.1.50",
-    "@atscript/db": "0.1.59"
+    "@atscript/db": "0.1.60"
   },
   "peerDependencies": {
     "@atscript/db": "^0.1.44",