@alpacakit/core 0.1.0-beta.26 → 0.1.0-beta.30

package/dist/ids.d.ts

@@ -1,6 +1,9 @@
 import type { Brand } from "./types.js";
 export declare const ID_PART_SEPARATOR = ":";
 export declare function joinIdParts(...parts: readonly string[]): string;
+export type StringTupleKey = Brand<string, "StringTupleKey">;
+/** Encodes tuple identity without relying on a delimiter that values may contain. */
+export declare function encodeStringTupleKey(...parts: readonly [string, ...string[]]): StringTupleKey;
 export declare function makeBrandedId<TBrand extends string>(value: string): Brand<string, TBrand>;
 export declare function makeJoinedBrandedId<TBrand extends string>(...parts: readonly string[]): Brand<string, TBrand>;
 type BrandedStringId = string & {

package/dist/ids.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,wBAAgB,WAAW,CAAC,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE/D;AAED,wBAAgB,aAAa,CAAC,MAAM,SAAS,MAAM,EACjD,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAMvB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,MAAM,EACvD,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,GAC1B,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAEvB;AAED,KAAK,eAAe,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAC7D,KAAK,eAAe,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,wBAAgB,qBAAqB,CAAC,GAAG,SAAS,eAAe,KAAK,CACpE,KAAK,EAAE,MAAM,KACV,GAAG,CAEP;AAED,wBAAgB,+BAA+B,CAAC,GAAG,SAAS,eAAe,EACzE,IAAI,EAAE,MAAM,GACX,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAQxB"}
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,wBAAgB,WAAW,CAAC,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE/D;AAED,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAE7D,qFAAqF;AACrF,wBAAgB,oBAAoB,CAClC,GAAG,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,GACvC,cAAc,CAEhB;AAED,wBAAgB,aAAa,CAAC,MAAM,SAAS,MAAM,EACjD,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAMvB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,MAAM,EACvD,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,GAC1B,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAEvB;AAED,KAAK,eAAe,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAC7D,KAAK,eAAe,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,wBAAgB,qBAAqB,CAAC,GAAG,SAAS,eAAe,KAAK,CACpE,KAAK,EAAE,MAAM,KACV,GAAG,CAEP;AAED,wBAAgB,+BAA+B,CAAC,GAAG,SAAS,eAAe,EACzE,IAAI,EAAE,MAAM,GACX,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,CAQxB"}

package/dist/ids.js

@@ -2,6 +2,10 @@ export const ID_PART_SEPARATOR = ":";
 export function joinIdParts(...parts) {
     return parts.join(ID_PART_SEPARATOR);
 }
+/** Encodes tuple identity without relying on a delimiter that values may contain. */
+export function encodeStringTupleKey(...parts) {
+    return makeBrandedId(JSON.stringify(parts));
+}
 export function makeBrandedId(value) {
     if (value.trim().length === 0) {
         throw new Error("A branded id must be a non-empty string.");

package/dist/index.d.ts

@@ -11,4 +11,5 @@ export * from "./ports.js";
 export * from "./registry.js";
 export * from "./schema.js";
 export * from "./types.js";
+export * from "./validation.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -11,3 +11,4 @@ export * from "./ports.js";
 export * from "./registry.js";
 export * from "./schema.js";
 export * from "./types.js";
+export * from "./validation.js";

package/dist/types.d.ts

@@ -3,6 +3,7 @@ export type Brand<TValue, TBrand extends string> = TValue & {
 };
 export type Nullable<TValue> = TValue | null;
 export type ValueOf<TValueMap> = TValueMap[keyof TValueMap];
+export type NonEmptyReadonlyArray<TValue> = readonly [TValue, ...TValue[]];
 export type ReadonlyRecord<TValue> = {
     readonly [key: string]: TValue;
 };

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,CAAC,MAAM,EAAE,MAAM,SAAS,MAAM,IAAI,MAAM,GAAG;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,QAAQ,CAAC,MAAM,IAAI,MAAM,GAAG,IAAI,CAAC;AAE7C,MAAM,MAAM,OAAO,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,SAAS,CAAC,CAAC;AAE5D,MAAM,MAAM,cAAc,CAAC,MAAM,IAAI;IACnC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,SAAS,SAAS,EAAE,GACpB;IACE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AACN,MAAM,MAAM,SAAS,GAAG,SAAS,SAAS,EAAE,CAAC;AAC7C,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AACF,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC;AAElC,MAAM,WAAW,cAAc,CAAC,EAAE,EAAE,IAAI,SAAS,MAAM,EAAE,SAAS;IAChE,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,CAAC,MAAM,EAAE,MAAM,SAAS,MAAM,IAAI,MAAM,GAAG;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,QAAQ,CAAC,MAAM,IAAI,MAAM,GAAG,IAAI,CAAC;AAE7C,MAAM,MAAM,OAAO,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,SAAS,CAAC,CAAC;AAE5D,MAAM,MAAM,qBAAqB,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AAE3E,MAAM,MAAM,cAAc,CAAC,MAAM,IAAI;IACnC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,SAAS,SAAS,EAAE,GACpB;IACE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AACN,MAAM,MAAM,SAAS,GAAG,SAAS,SAAS,EAAE,CAAC;AAC7C,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AACF,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC;AAElC,MAAM,WAAW,cAAc,CAAC,EAAE,EAAE,IAAI,SAAS,MAAM,EAAE,SAAS;IAChE,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B"}

package/dist/validation.d.ts

@@ -0,0 +1,6 @@
+import type { NonEmptyReadonlyArray } from "./types.js";
+/** Lists every member from the closed vocabulary that owns the values. */
+export declare function listClosedVocabularyValues<Vocabulary extends object>(vocabulary: Vocabulary): NonEmptyReadonlyArray<Vocabulary[keyof Vocabulary]>;
+/** Returns the input after proving that it is a positive safe integer. */
+export declare function requirePositiveSafeInteger(value: number, label: string): number;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AASxD,0EAA0E;AAC1E,wBAAgB,0BAA0B,CAAC,UAAU,SAAS,MAAM,EAClE,UAAU,EAAE,UAAU,GACrB,qBAAqB,CAAC,UAAU,CAAC,MAAM,UAAU,CAAC,CAAC,CAMrD;AAED,0EAA0E;AAC1E,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,MAAM,CAKR"}

package/dist/validation.js

@@ -0,0 +1,19 @@
+const CORE_VALIDATION_ERROR_MESSAGE = {
+    emptyClosedVocabulary: "A closed vocabulary must declare at least one member.",
+    positiveSafeInteger: (label) => `${label} must be a positive safe integer.`,
+};
+/** Lists every member from the closed vocabulary that owns the values. */
+export function listClosedVocabularyValues(vocabulary) {
+    const values = Object.values(vocabulary);
+    if (values.length === 0) {
+        throw new Error(CORE_VALIDATION_ERROR_MESSAGE.emptyClosedVocabulary);
+    }
+    return [values[0], ...values.slice(1)];
+}
+/** Returns the input after proving that it is a positive safe integer. */
+export function requirePositiveSafeInteger(value, label) {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new Error(CORE_VALIDATION_ERROR_MESSAGE.positiveSafeInteger(label));
+    }
+    return value;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alpacakit/core",
-  "version": "0.1.0-beta.26",
+  "version": "0.1.0-beta.30",
   "description": "Architecture-neutral kernel primitives: branded ids, ports, registries, pipelines, payload codecs, and immutable mutation helpers.",
   "license": "MIT",
   "type": "module",