@pwfabric/contracts 0.0.0-stage → 1.0.0-rc.0

package/dist/core/ids.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Identity and Addressing Primitives
+ *
+ * PHASE0-WS1: Core identity types for PWFabric
+ *
+ * These types use branded types (opaque types) to provide
+ * compile-time safety for different ID types that are
+ * structurally identical (all strings) but semantically distinct.
+ *
+ * @module @pwfabric/contracts/core/ids
+ */
+/**
+ * Brand symbol for nominal typing
+ */
+declare const brand: unique symbol;
+/**
+ * Branded type helper - creates nominally typed strings
+ */
+type Brand<T, B extends string> = T & {
+    readonly [brand]: B;
+};
+/**
+ * Unique identifier for a Fabric instance
+ */
+export type FabricId = Brand<string, 'FabricId'>;
+/**
+ * Unique identifier for a Capability
+ */
+export type CapabilityId = Brand<string, 'CapabilityId'>;
+/**
+ * Unique identifier for a Contract
+ */
+export type ContractId = Brand<string, 'ContractId'>;
+/**
+ * Unique identifier for a Surface
+ */
+export type SurfaceId = Brand<string, 'SurfaceId'>;
+/**
+ * Unique identifier for a Manifestation
+ */
+export type ManifestationId = Brand<string, 'ManifestationId'>;
+/**
+ * Unique identifier for a Domain
+ */
+export type DomainId = Brand<string, 'DomainId'>;
+/**
+ * Unique identifier for an Owner (human or system)
+ */
+export type OwnerId = Brand<string, 'OwnerId'>;
+/**
+ * Unique identifier for an Artifact
+ */
+export type ArtifactId = Brand<string, 'ArtifactId'>;
+/**
+ * User identifier — auth principal. A single user may belong to many Worlds.
+ */
+export type UserId = Brand<string, 'UserId'>;
+/**
+ * ISO 8601 datetime string. Branded for documentation; runtime is plain string.
+ * Always UTC; suffix `Z` required.
+ */
+export type ISODateTime = Brand<string, 'ISODateTime'>;
+/**
+ * Create a FabricId from a string
+ * Runtime validation should be performed by the caller
+ */
+export declare function fabricId(id: string): FabricId;
+/**
+ * Create a CapabilityId from a string
+ */
+export declare function capabilityId(id: string): CapabilityId;
+/**
+ * Create a ContractId from a string
+ */
+export declare function contractId(id: string): ContractId;
+/**
+ * Create a SurfaceId from a string
+ */
+export declare function surfaceId(id: string): SurfaceId;
+/**
+ * Create a ManifestationId from a string
+ */
+export declare function manifestationId(id: string): ManifestationId;
+/**
+ * Create a DomainId from a string
+ */
+export declare function domainId(id: string): DomainId;
+/**
+ * Create an OwnerId from a string
+ */
+export declare function ownerId(id: string): OwnerId;
+/**
+ * Create an ArtifactId from a string
+ */
+export declare function artifactId(id: string): ArtifactId;
+export declare function userId(id: string): UserId;
+export declare function isoDateTime(s: string): ISODateTime;
+/**
+ * ID format: namespace/name or namespace/name@version
+ * Examples:
+ *   - "auth/login"
+ *   - "payments/process@1.0.0"
+ *   - "core/validate"
+ */
+export declare const ID_PATTERN: RegExp;
+/**
+ * Check if a string is a valid PWFabric ID format
+ */
+export declare function isValidId(id: string): boolean;
+/**
+ * Parse an ID into namespace and name parts
+ */
+export declare function parseId(id: string): {
+    namespace: string;
+    name: string;
+    version?: string;
+} | null;
+export {};
+//# sourceMappingURL=ids.d.ts.map

package/dist/core/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/core/ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,OAAO,CAAC,MAAM,KAAK,EAAE,OAAO,MAAM,CAAA;AAElC;;GAEG;AACH,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;CAAE,CAAA;AAM7D;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;AAEhD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;AAExD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;AAEpD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;AAElD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;AAE9D;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;AAEhD;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AAE9C;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;AAMpD;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;AAE5C;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;AAMtD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAE7C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAErD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAEjD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAE/C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,CAE3D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAE7C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE3C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAEjD;AAMD,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEzC;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAElD;AAMD;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,QAAuE,CAAA;AAE9F;;GAEG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAchG"}

package/dist/core/ids.js

@@ -0,0 +1,106 @@
+/**
+ * Identity and Addressing Primitives
+ *
+ * PHASE0-WS1: Core identity types for PWFabric
+ *
+ * These types use branded types (opaque types) to provide
+ * compile-time safety for different ID types that are
+ * structurally identical (all strings) but semantically distinct.
+ *
+ * @module @pwfabric/contracts/core/ids
+ */
+// ============================================================
+// ID CONSTRUCTORS
+// ============================================================
+/**
+ * Create a FabricId from a string
+ * Runtime validation should be performed by the caller
+ */
+export function fabricId(id) {
+    return id;
+}
+/**
+ * Create a CapabilityId from a string
+ */
+export function capabilityId(id) {
+    return id;
+}
+/**
+ * Create a ContractId from a string
+ */
+export function contractId(id) {
+    return id;
+}
+/**
+ * Create a SurfaceId from a string
+ */
+export function surfaceId(id) {
+    return id;
+}
+/**
+ * Create a ManifestationId from a string
+ */
+export function manifestationId(id) {
+    return id;
+}
+/**
+ * Create a DomainId from a string
+ */
+export function domainId(id) {
+    return id;
+}
+/**
+ * Create an OwnerId from a string
+ */
+export function ownerId(id) {
+    return id;
+}
+/**
+ * Create an ArtifactId from a string
+ */
+export function artifactId(id) {
+    return id;
+}
+// ============================================================
+// WORLD LAYER ID CONSTRUCTORS
+// ============================================================
+export function userId(id) {
+    return id;
+}
+export function isoDateTime(s) {
+    return s;
+}
+// ============================================================
+// ID VALIDATION
+// ============================================================
+/**
+ * ID format: namespace/name or namespace/name@version
+ * Examples:
+ *   - "auth/login"
+ *   - "payments/process@1.0.0"
+ *   - "core/validate"
+ */
+export const ID_PATTERN = /^[a-z][a-z0-9-]*\/[a-z][a-z0-9-]*(@\d+\.\d+\.\d+(-[a-z0-9.]+)?)?$/i;
+/**
+ * Check if a string is a valid PWFabric ID format
+ */
+export function isValidId(id) {
+    return ID_PATTERN.test(id);
+}
+/**
+ * Parse an ID into namespace and name parts
+ */
+export function parseId(id) {
+    const match = id.match(/^([a-z][a-z0-9-]*)\/([a-z][a-z0-9-]*)(?:@(.+))?$/i);
+    if (!match || !match[1] || !match[2])
+        return null;
+    const result = {
+        namespace: match[1],
+        name: match[2],
+    };
+    if (match[3]) {
+        result.version = match[3];
+    }
+    return result;
+}
+//# sourceMappingURL=ids.js.map

package/dist/core/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/core/ids.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAuEH,+DAA+D;AAC/D,kBAAkB;AAClB,+DAA+D;AAE/D;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAU;IACjC,OAAO,EAAc,CAAA;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,EAAkB,CAAA;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,EAAgB,CAAA;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,OAAO,EAAe,CAAA;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,EAAqB,CAAA;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAU;IACjC,OAAO,EAAc,CAAA;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,EAAU;IAChC,OAAO,EAAa,CAAA;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,EAAgB,CAAA;AACzB,CAAC;AAED,+DAA+D;AAC/D,8BAA8B;AAC9B,+DAA+D;AAE/D,MAAM,UAAU,MAAM,CAAC,EAAU;IAC/B,OAAO,EAAY,CAAA;AACrB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,OAAO,CAAgB,CAAA;AACzB,CAAC;AAED,+DAA+D;AAC/D,gBAAgB;AAChB,+DAA+D;AAE/D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,oEAAoE,CAAA;AAE9F;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,OAAO,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,EAAU;IAChC,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAA;IAC3E,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IAEjD,MAAM,MAAM,GAA0D;QACpE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QACnB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;KACf,CAAA;IAED,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACb,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IAC3B,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Core Contract Primitives
+ *
+ * PHASE0-WS1: Foundational types for PWFabric
+ *
+ * @module @pwfabric/contracts/core
+ */
+export * from './ids.js';
+export * from './version.js';
+export * from './result.js';
+export * from './schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,cAAc,UAAU,CAAA;AAGxB,cAAc,cAAc,CAAA;AAG5B,cAAc,aAAa,CAAA;AAG3B,cAAc,aAAa,CAAA"}

package/dist/core/index.js

@@ -0,0 +1,16 @@
+/**
+ * Core Contract Primitives
+ *
+ * PHASE0-WS1: Foundational types for PWFabric
+ *
+ * @module @pwfabric/contracts/core
+ */
+// Identity and addressing
+export * from './ids.js';
+// Semantic versioning
+export * from './version.js';
+// Result types
+export * from './result.js';
+// Schema types
+export * from './schema.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,0BAA0B;AAC1B,cAAc,UAAU,CAAA;AAExB,sBAAsB;AACtB,cAAc,cAAc,CAAA;AAE5B,eAAe;AACf,cAAc,aAAa,CAAA;AAE3B,eAAe;AACf,cAAc,aAAa,CAAA"}

package/dist/core/result.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Result Types for Operations
+ *
+ * PHASE0-WS1: Typed result handling without exceptions
+ *
+ * @module @pwfabric/contracts/core/result
+ */
+/**
+ * Success result
+ */
+export interface Success<T> {
+    readonly success: true;
+    readonly data: T;
+}
+/**
+ * Failure result
+ */
+export interface Failure<E> {
+    readonly success: false;
+    readonly error: E;
+}
+/**
+ * Result type for operations that can fail
+ * Encodes success/failure in the type system
+ */
+export type Result<T, E = Error> = Success<T> | Failure<E>;
+/**
+ * Async result type
+ */
+export type AsyncResult<T, E = Error> = Promise<Result<T, E>>;
+/**
+ * Create a success result
+ */
+export declare function ok<T>(data: T): Success<T>;
+/**
+ * Create a failure result
+ */
+export declare function err<E>(error: E): Failure<E>;
+/**
+ * Check if result is successful
+ */
+export declare function isOk<T, E>(result: Result<T, E>): result is Success<T>;
+/**
+ * Check if result is a failure
+ */
+export declare function isErr<T, E>(result: Result<T, E>): result is Failure<E>;
+/**
+ * Unwrap a result, throwing if it's a failure
+ */
+export declare function unwrap<T, E>(result: Result<T, E>): T;
+/**
+ * Unwrap a result with a default value
+ */
+export declare function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T;
+/**
+ * Map over a successful result
+ */
+export declare function mapResult<T, U, E>(result: Result<T, E>, fn: (data: T) => U): Result<U, E>;
+/**
+ * Map over a failure result
+ */
+export declare function mapError<T, E, F>(result: Result<T, E>, fn: (error: E) => F): Result<T, F>;
+/**
+ * FlatMap (bind) over a result
+ */
+export declare function flatMap<T, U, E>(result: Result<T, E>, fn: (data: T) => Result<U, E>): Result<U, E>;
+/**
+ * Validation error details
+ */
+export interface ValidationError {
+    readonly path: string[];
+    readonly message: string;
+    readonly code: string;
+}
+/**
+ * Validation result type
+ */
+export type ValidationResult<T = unknown> = Result<T, ValidationError[]>;
+/**
+ * Create a validation success
+ */
+export declare function validationOk<T>(data: T): ValidationResult<T>;
+/**
+ * Create a validation failure
+ */
+export declare function validationErr(errors: ValidationError[]): ValidationResult<never>;
+/**
+ * Create a single validation error
+ */
+export declare function validationError(path: string[], message: string, code: string): ValidationError;
+//# sourceMappingURL=result.d.ts.map

package/dist/core/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/core/result.ts"],"names":[],"mappings":"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"}

package/dist/core/result.js

@@ -0,0 +1,104 @@
+/**
+ * Result Types for Operations
+ *
+ * PHASE0-WS1: Typed result handling without exceptions
+ *
+ * @module @pwfabric/contracts/core/result
+ */
+// ============================================================
+// RESULT CONSTRUCTORS
+// ============================================================
+/**
+ * Create a success result
+ */
+export function ok(data) {
+    return { success: true, data };
+}
+/**
+ * Create a failure result
+ */
+export function err(error) {
+    return { success: false, error };
+}
+// ============================================================
+// RESULT TYPE GUARDS
+// ============================================================
+/**
+ * Check if result is successful
+ */
+export function isOk(result) {
+    return result.success === true;
+}
+/**
+ * Check if result is a failure
+ */
+export function isErr(result) {
+    return result.success === false;
+}
+// ============================================================
+// RESULT UTILITIES
+// ============================================================
+/**
+ * Unwrap a result, throwing if it's a failure
+ */
+export function unwrap(result) {
+    if (result.success) {
+        return result.data;
+    }
+    throw result.error;
+}
+/**
+ * Unwrap a result with a default value
+ */
+export function unwrapOr(result, defaultValue) {
+    if (result.success) {
+        return result.data;
+    }
+    return defaultValue;
+}
+/**
+ * Map over a successful result
+ */
+export function mapResult(result, fn) {
+    if (result.success) {
+        return ok(fn(result.data));
+    }
+    return result;
+}
+/**
+ * Map over a failure result
+ */
+export function mapError(result, fn) {
+    if (!result.success) {
+        return err(fn(result.error));
+    }
+    return result;
+}
+/**
+ * FlatMap (bind) over a result
+ */
+export function flatMap(result, fn) {
+    if (result.success) {
+        return fn(result.data);
+    }
+    return result;
+}
+/**
+ * Create a validation success
+ */
+export function validationOk(data) {
+    return ok(data);
+}
+/**
+ * Create a validation failure
+ */
+export function validationErr(errors) {
+    return err(errors);
+}
+/**
+ * Create a single validation error
+ */
+export function validationError(path, message, code) {
+    return { path, message, code };
+}
+//# sourceMappingURL=result.js.map

package/dist/core/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/core/result.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiCH,+DAA+D;AAC/D,sBAAsB;AACtB,+DAA+D;AAE/D;;GAEG;AACH,MAAM,UAAU,EAAE,CAAI,IAAO;IAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAI,KAAQ;IAC7B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;AAClC,CAAC;AAED,+DAA+D;AAC/D,qBAAqB;AACrB,+DAA+D;AAE/D;;GAEG;AACH,MAAM,UAAU,IAAI,CAAO,MAAoB;IAC7C,OAAO,MAAM,CAAC,OAAO,KAAK,IAAI,CAAA;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAO,MAAoB;IAC9C,OAAO,MAAM,CAAC,OAAO,KAAK,KAAK,CAAA;AACjC,CAAC;AAED,+DAA+D;AAC/D,mBAAmB;AACnB,+DAA+D;AAE/D;;GAEG;AACH,MAAM,UAAU,MAAM,CAAO,MAAoB;IAC/C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,IAAI,CAAA;IACpB,CAAC;IACD,MAAM,MAAM,CAAC,KAAK,CAAA;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAO,MAAoB,EAAE,YAAe;IAClE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,IAAI,CAAA;IACpB,CAAC;IACD,OAAO,YAAY,CAAA;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAU,MAAoB,EAAE,EAAkB;IACzE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IAC5B,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAU,MAAoB,EAAE,EAAmB;IACzE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IAC9B,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CACrB,MAAoB,EACpB,EAA6B;IAE7B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACxB,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAoBD;;GAEG;AACH,MAAM,UAAU,YAAY,CAAI,IAAO;IACrC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAA;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAyB;IACrD,OAAO,GAAG,CAAC,MAAM,CAAC,CAAA;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAc,EAAE,OAAe,EAAE,IAAY;IAC3E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AAChC,CAAC"}

package/dist/core/schema.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Schema Types for Contract Validation
+ *
+ * PHASE0-WS1: Runtime-validated, serializable schema definitions
+ *
+ * These types define the shape of validation schemas without
+ * coupling to a specific validation library.
+ *
+ * @module @pwfabric/contracts/core/schema
+ */
+import type { ValidationResult } from './result.js';
+/**
+ * Supported primitive types in schemas
+ */
+export type SchemaType = 'string' | 'number' | 'boolean' | 'null' | 'array' | 'object' | 'union' | 'literal' | 'unknown';
+/**
+ * Base schema definition
+ */
+export interface SchemaDefinition {
+    readonly type: SchemaType;
+    readonly nullable?: boolean;
+    readonly optional?: boolean;
+    readonly description?: string;
+}
+/**
+ * String schema
+ */
+export interface StringSchema extends SchemaDefinition {
+    readonly type: 'string';
+    readonly minLength?: number;
+    readonly maxLength?: number;
+    readonly pattern?: string;
+    readonly format?: 'email' | 'uuid' | 'uri' | 'date' | 'datetime';
+}
+/**
+ * Number schema
+ */
+export interface NumberSchema extends SchemaDefinition {
+    readonly type: 'number';
+    readonly minimum?: number;
+    readonly maximum?: number;
+    readonly integer?: boolean;
+}
+/**
+ * Boolean schema
+ */
+export interface BooleanSchema extends SchemaDefinition {
+    readonly type: 'boolean';
+}
+/**
+ * Null schema
+ */
+export interface NullSchema extends SchemaDefinition {
+    readonly type: 'null';
+}
+/**
+ * Array schema
+ */
+export interface ArraySchema extends SchemaDefinition {
+    readonly type: 'array';
+    readonly items: AnySchema;
+    readonly minItems?: number;
+    readonly maxItems?: number;
+}
+/**
+ * Object schema
+ */
+export interface ObjectSchema extends SchemaDefinition {
+    readonly type: 'object';
+    readonly properties: Record<string, AnySchema>;
+    readonly required?: string[];
+    readonly additionalProperties?: boolean | AnySchema;
+}
+/**
+ * Union schema (discriminated or simple)
+ */
+export interface UnionSchema extends SchemaDefinition {
+    readonly type: 'union';
+    readonly variants: AnySchema[];
+    readonly discriminator?: string;
+}
+/**
+ * Literal schema
+ */
+export interface LiteralSchema extends SchemaDefinition {
+    readonly type: 'literal';
+    readonly value: string | number | boolean;
+}
+/**
+ * Unknown schema (accepts any value)
+ */
+export interface UnknownSchema extends SchemaDefinition {
+    readonly type: 'unknown';
+}
+/**
+ * Any valid schema
+ */
+export type AnySchema = StringSchema | NumberSchema | BooleanSchema | NullSchema | ArraySchema | ObjectSchema | UnionSchema | LiteralSchema | UnknownSchema;
+/**
+ * Schema validator interface
+ *
+ * This interface abstracts the validation logic, allowing
+ * different implementations (Zod, Yup, custom, etc.)
+ */
+export interface Schema<T = unknown> {
+    /**
+     * The schema definition (serializable)
+     */
+    readonly definition: AnySchema;
+    /**
+     * Validate data against the schema
+     */
+    validate(data: unknown): ValidationResult<T>;
+    /**
+     * Parse data (validate and transform)
+     */
+    parse(data: unknown): T;
+    /**
+     * Safe parse (returns result instead of throwing)
+     */
+    safeParse(data: unknown): ValidationResult<T>;
+    /**
+     * Serialize the schema to JSON Schema format
+     */
+    toJsonSchema(): JsonSchema;
+}
+/**
+ * JSON Schema compatible format
+ * Subset of JSON Schema Draft-07
+ */
+export interface JsonSchema {
+    $schema?: string;
+    $id?: string;
+    title?: string;
+    description?: string;
+    type?: string | string[];
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    enum?: unknown[];
+    const?: unknown;
+    oneOf?: JsonSchema[];
+    anyOf?: JsonSchema[];
+    allOf?: JsonSchema[];
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+    minimum?: number;
+    maximum?: number;
+    minItems?: number;
+    maxItems?: number;
+    additionalProperties?: boolean | JsonSchema;
+}
+/**
+ * Serialized contract schema (for network transport)
+ */
+export interface SerializedSchema {
+    readonly version: string;
+    readonly definition: AnySchema;
+    readonly jsonSchema: JsonSchema;
+}
+/**
+ * Serialize a schema definition to JSON Schema
+ */
+export declare function toJsonSchema(schema: AnySchema): JsonSchema;
+//# sourceMappingURL=schema.d.ts.map

package/dist/core/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"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"}