@iveri/contracts 0.1.0 → 0.3.0

package/dist/esm/api/identity/index.d.ts

@@ -0,0 +1,4 @@
+export * from './auth.type.js';
+export * from './membership-status.enum.js';
+export * from './tenant-status.enum.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/api/identity/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/identity/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC"}

package/dist/esm/api/identity/index.js

@@ -0,0 +1,4 @@
+export * from './auth.type.js';
+export * from './membership-status.enum.js';
+export * from './tenant-status.enum.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/api/identity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/api/identity/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC"}

package/dist/esm/api/identity/membership-status.enum.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A user's standing inside their tenant.
+ *
+ * Lives on the membership rather than the user because it is a statement about access, not
+ * about identity — and keeping the two apart is what stops "deactivate this person" and
+ * "delete this account" from becoming the same operation.
+ */
+export declare enum MembershipStatus {
+    /** Invited but has not set a password yet. Cannot authenticate. */
+    INVITED = "INVITED",
+    /** Normal operation. */
+    ACTIVE = "ACTIVE",
+    /** Access revoked without deleting anything. Reversible; existing sessions stop working. */
+    SUSPENDED = "SUSPENDED"
+}
+//# sourceMappingURL=membership-status.enum.d.ts.map

package/dist/esm/api/identity/membership-status.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"membership-status.enum.d.ts","sourceRoot":"","sources":["../../../../src/api/identity/membership-status.enum.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,oBAAY,gBAAgB;IACxB,mEAAmE;IACnE,OAAO,YAAY;IAEnB,wBAAwB;IACxB,MAAM,WAAW;IAEjB,4FAA4F;IAC5F,SAAS,cAAc;CAC1B"}

package/dist/esm/api/identity/membership-status.enum.js

@@ -0,0 +1,17 @@
+/**
+ * A user's standing inside their tenant.
+ *
+ * Lives on the membership rather than the user because it is a statement about access, not
+ * about identity — and keeping the two apart is what stops "deactivate this person" and
+ * "delete this account" from becoming the same operation.
+ */
+export var MembershipStatus;
+(function (MembershipStatus) {
+    /** Invited but has not set a password yet. Cannot authenticate. */
+    MembershipStatus["INVITED"] = "INVITED";
+    /** Normal operation. */
+    MembershipStatus["ACTIVE"] = "ACTIVE";
+    /** Access revoked without deleting anything. Reversible; existing sessions stop working. */
+    MembershipStatus["SUSPENDED"] = "SUSPENDED";
+})(MembershipStatus || (MembershipStatus = {}));
+//# sourceMappingURL=membership-status.enum.js.map

package/dist/esm/api/identity/membership-status.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"membership-status.enum.js","sourceRoot":"","sources":["../../../../src/api/identity/membership-status.enum.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,gBASX;AATD,WAAY,gBAAgB;IACxB,mEAAmE;IACnE,uCAAmB,CAAA;IAEnB,wBAAwB;IACxB,qCAAiB,CAAA;IAEjB,4FAA4F;IAC5F,2CAAuB,CAAA;AAC3B,CAAC,EATW,gBAAgB,KAAhB,gBAAgB,QAS3B"}

package/dist/esm/api/identity/tenant-status.enum.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Lifecycle state of a tenant.
+ *
+ * Every authenticated request checks it, so a suspended tenant loses access without any of its
+ * data being touched.
+ *
+ * Lives here rather than in `iveri-identity-api` because it is on the wire: it rides inside
+ * every principal, which means every service and every frontend reads it. `conduit-admin-web`
+ * hand-transcribed it as `'active' | 'suspended' | 'cancelled'` — wrong casing and a member
+ * identity has never had — and nothing caught it, because a hand-written mirror of an enum is
+ * checked by nobody. That is the whole argument for this directory.
+ */
+export declare enum TenantStatus {
+    /** Normal operation. */
+    ACTIVE = "ACTIVE",
+    /**
+     * Access blocked — non-payment, abuse, or a customer request. Reversible, and nothing is
+     * deleted. Logins fail and existing access tokens stop working at the next request.
+     */
+    SUSPENDED = "SUSPENDED",
+    /**
+     * Scheduled for erasure. Behaves like `SUSPENDED` for access purposes; the distinction is
+     * that the data is on its way out, which matters for a GDPR deletion request having a
+     * documented, auditable state rather than a row silently vanishing.
+     */
+    PENDING_DELETION = "PENDING_DELETION"
+}
+//# sourceMappingURL=tenant-status.enum.d.ts.map

package/dist/esm/api/identity/tenant-status.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-status.enum.d.ts","sourceRoot":"","sources":["../../../../src/api/identity/tenant-status.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,oBAAY,YAAY;IACpB,wBAAwB;IACxB,MAAM,WAAW;IAEjB;;;OAGG;IACH,SAAS,cAAc;IAEvB;;;;OAIG;IACH,gBAAgB,qBAAqB;CACxC"}

package/dist/esm/api/identity/tenant-status.enum.js

@@ -0,0 +1,29 @@
+/**
+ * Lifecycle state of a tenant.
+ *
+ * Every authenticated request checks it, so a suspended tenant loses access without any of its
+ * data being touched.
+ *
+ * Lives here rather than in `iveri-identity-api` because it is on the wire: it rides inside
+ * every principal, which means every service and every frontend reads it. `conduit-admin-web`
+ * hand-transcribed it as `'active' | 'suspended' | 'cancelled'` — wrong casing and a member
+ * identity has never had — and nothing caught it, because a hand-written mirror of an enum is
+ * checked by nobody. That is the whole argument for this directory.
+ */
+export var TenantStatus;
+(function (TenantStatus) {
+    /** Normal operation. */
+    TenantStatus["ACTIVE"] = "ACTIVE";
+    /**
+     * Access blocked — non-payment, abuse, or a customer request. Reversible, and nothing is
+     * deleted. Logins fail and existing access tokens stop working at the next request.
+     */
+    TenantStatus["SUSPENDED"] = "SUSPENDED";
+    /**
+     * Scheduled for erasure. Behaves like `SUSPENDED` for access purposes; the distinction is
+     * that the data is on its way out, which matters for a GDPR deletion request having a
+     * documented, auditable state rather than a row silently vanishing.
+     */
+    TenantStatus["PENDING_DELETION"] = "PENDING_DELETION";
+})(TenantStatus || (TenantStatus = {}));
+//# sourceMappingURL=tenant-status.enum.js.map

package/dist/esm/api/identity/tenant-status.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-status.enum.js","sourceRoot":"","sources":["../../../../src/api/identity/tenant-status.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAN,IAAY,YAgBX;AAhBD,WAAY,YAAY;IACpB,wBAAwB;IACxB,iCAAiB,CAAA;IAEjB;;;OAGG;IACH,uCAAuB,CAAA;IAEvB;;;;OAIG;IACH,qDAAqC,CAAA;AACzC,CAAC,EAhBW,YAAY,KAAZ,YAAY,QAgBvB"}

package/dist/esm/enum/index.d.ts

@@ -1,2 +1,3 @@
 export * from './error-code.enum.js';
+export * from './user-permission.enum.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/enum/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/enum/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/enum/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC"}

package/dist/esm/enum/index.js

@@ -1,2 +1,3 @@
 export * from './error-code.enum.js';
+export * from './user-permission.enum.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/enum/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/enum/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/enum/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC"}

package/dist/esm/enum/user-permission.enum.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Every action a principal can be granted in an Iveri tenant, across every service.
+ *
+ * A permission is a **contract**, not an implementation detail: `iveri-identity-api` stores
+ * members on role rows and resolves them into access tokens, every other service reads them
+ * out of that token to authorize a request, and the frontend's `<RequirePermission>` branches
+ * on the same values. A member's wire value therefore never changes, and a member is never
+ * removed while issued tokens can still carry it — removing one silently downgrades every
+ * live session holding it. Adding one is a minor version.
+ *
+ * **One catalogue for the whole platform, deliberately.** Identity validates custom-role input
+ * against this list, so a permission it has never heard of cannot be granted. A service that
+ * defined its own enum locally would find its permissions unassignable.
+ *
+ * Values are `<resource>:<action>` — or `<service>:<resource>:<action>` where a resource name
+ * would otherwise collide across services — lowercase, so a token payload is readable in a
+ * log and a wildcard match (`role:*`) stays possible if we ever need one.
+ */
+export declare enum UserPermission {
+    TENANT_READ = "tenant:read",
+    TENANT_UPDATE = "tenant:update",
+    /** Schedules the tenant for deletion. Owner-only; there is no undo path built yet. */
+    TENANT_DELETE = "tenant:delete",
+    USER_READ = "user:read",
+    USER_INVITE = "user:invite",
+    USER_UPDATE = "user:update",
+    USER_REMOVE = "user:remove",
+    MEMBERSHIP_READ = "membership:read",
+    /** Suspend or reactivate someone's access without deleting their account. */
+    MEMBERSHIP_UPDATE = "membership:update",
+    /**
+     * Change which roles a membership holds. Separate from `MEMBERSHIP_UPDATE` because
+     * granting roles is privilege escalation and deserves its own gate.
+     */
+    MEMBERSHIP_ASSIGN_ROLE = "membership:assign-role",
+    ROLE_READ = "role:read",
+    ROLE_CREATE = "role:create",
+    ROLE_UPDATE = "role:update",
+    ROLE_DELETE = "role:delete",
+    API_KEY_READ = "api-key:read",
+    API_KEY_ISSUE = "api-key:issue",
+    API_KEY_REVOKE = "api-key:revoke",
+    /** Read endpoint configuration. Never exposes the signing secret. */
+    CONDUIT_ENDPOINT_READ = "conduit:endpoint:read",
+    CONDUIT_ENDPOINT_CREATE = "conduit:endpoint:create",
+    CONDUIT_ENDPOINT_UPDATE = "conduit:endpoint:update",
+    CONDUIT_ENDPOINT_DELETE = "conduit:endpoint:delete",
+    /**
+     * List and read captured requests, **including their raw bodies and headers**. Captures
+     * hold whatever a provider sent — order details, message contents, personal data — so
+     * this is closer to a data-export permission than a config one.
+     */
+    CONDUIT_CAPTURE_READ = "conduit:capture:read",
+    CONDUIT_CAPTURE_DELETE = "conduit:capture:delete",
+    /**
+     * Resend a captured request to an arbitrary URL. Separate from `CONDUIT_CAPTURE_READ`
+     * because it makes an outbound request from our infrastructure with a body the caller
+     * controls, which is a materially different power from reading a row.
+     */
+    CONDUIT_REPLAY_EXECUTE = "conduit:replay:execute",
+    CONDUIT_PROVIDER_READ = "conduit:provider:read",
+    /** Define or amend a custom provider manifest — signature scheme, headers, handshake. */
+    CONDUIT_PROVIDER_MANAGE = "conduit:provider:manage"
+}
+/**
+ * Every member, for seeding the owner role and validating custom-role input.
+ *
+ * Frozen because it is shared mutable state in a browser bundle otherwise: one caller sorting
+ * it in place reorders it for everyone.
+ */
+export declare const ALL_USER_PERMISSIONS: readonly UserPermission[];
+//# sourceMappingURL=user-permission.enum.d.ts.map

package/dist/esm/enum/user-permission.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-permission.enum.d.ts","sourceRoot":"","sources":["../../../src/enum/user-permission.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,oBAAY,cAAc;IAItB,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;IAC/B,sFAAsF;IACtF,aAAa,kBAAkB;IAG/B,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,WAAW,gBAAgB;IAC3B,WAAW,gBAAgB;IAG3B,eAAe,oBAAoB;IACnC,6EAA6E;IAC7E,iBAAiB,sBAAsB;IACvC;;;OAGG;IACH,sBAAsB,2BAA2B;IAGjD,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,WAAW,gBAAgB;IAC3B,WAAW,gBAAgB;IAG3B,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;IAKjC,qEAAqE;IACrE,qBAAqB,0BAA0B;IAC/C,uBAAuB,4BAA4B;IACnD,uBAAuB,4BAA4B;IACnD,uBAAuB,4BAA4B;IAGnD;;;;OAIG;IACH,oBAAoB,yBAAyB;IAC7C,sBAAsB,2BAA2B;IAGjD;;;;OAIG;IACH,sBAAsB,2BAA2B;IAGjD,qBAAqB,0BAA0B;IAC/C,yFAAyF;IACzF,uBAAuB,4BAA4B;CACtD;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,cAAc,EAAiD,CAAC"}

package/dist/esm/enum/user-permission.enum.js

@@ -0,0 +1,84 @@
+/**
+ * Every action a principal can be granted in an Iveri tenant, across every service.
+ *
+ * A permission is a **contract**, not an implementation detail: `iveri-identity-api` stores
+ * members on role rows and resolves them into access tokens, every other service reads them
+ * out of that token to authorize a request, and the frontend's `<RequirePermission>` branches
+ * on the same values. A member's wire value therefore never changes, and a member is never
+ * removed while issued tokens can still carry it — removing one silently downgrades every
+ * live session holding it. Adding one is a minor version.
+ *
+ * **One catalogue for the whole platform, deliberately.** Identity validates custom-role input
+ * against this list, so a permission it has never heard of cannot be granted. A service that
+ * defined its own enum locally would find its permissions unassignable.
+ *
+ * Values are `<resource>:<action>` — or `<service>:<resource>:<action>` where a resource name
+ * would otherwise collide across services — lowercase, so a token payload is readable in a
+ * log and a wildcard match (`role:*`) stays possible if we ever need one.
+ */
+export var UserPermission;
+(function (UserPermission) {
+    // ══ iveri-identity-api ═══════════════════════════════════════════════════
+    // ── Tenant ──────────────────────────────────────────────────────────────
+    UserPermission["TENANT_READ"] = "tenant:read";
+    UserPermission["TENANT_UPDATE"] = "tenant:update";
+    /** Schedules the tenant for deletion. Owner-only; there is no undo path built yet. */
+    UserPermission["TENANT_DELETE"] = "tenant:delete";
+    // ── User ────────────────────────────────────────────────────────────────
+    UserPermission["USER_READ"] = "user:read";
+    UserPermission["USER_INVITE"] = "user:invite";
+    UserPermission["USER_UPDATE"] = "user:update";
+    UserPermission["USER_REMOVE"] = "user:remove";
+    // ── Membership ──────────────────────────────────────────────────────────
+    UserPermission["MEMBERSHIP_READ"] = "membership:read";
+    /** Suspend or reactivate someone's access without deleting their account. */
+    UserPermission["MEMBERSHIP_UPDATE"] = "membership:update";
+    /**
+     * Change which roles a membership holds. Separate from `MEMBERSHIP_UPDATE` because
+     * granting roles is privilege escalation and deserves its own gate.
+     */
+    UserPermission["MEMBERSHIP_ASSIGN_ROLE"] = "membership:assign-role";
+    // ── Role ────────────────────────────────────────────────────────────────
+    UserPermission["ROLE_READ"] = "role:read";
+    UserPermission["ROLE_CREATE"] = "role:create";
+    UserPermission["ROLE_UPDATE"] = "role:update";
+    UserPermission["ROLE_DELETE"] = "role:delete";
+    // ── API key ─────────────────────────────────────────────────────────────
+    UserPermission["API_KEY_READ"] = "api-key:read";
+    UserPermission["API_KEY_ISSUE"] = "api-key:issue";
+    UserPermission["API_KEY_REVOKE"] = "api-key:revoke";
+    // ══ conduit-api ══════════════════════════════════════════════════════════
+    // ── Endpoint ────────────────────────────────────────────────────────────
+    /** Read endpoint configuration. Never exposes the signing secret. */
+    UserPermission["CONDUIT_ENDPOINT_READ"] = "conduit:endpoint:read";
+    UserPermission["CONDUIT_ENDPOINT_CREATE"] = "conduit:endpoint:create";
+    UserPermission["CONDUIT_ENDPOINT_UPDATE"] = "conduit:endpoint:update";
+    UserPermission["CONDUIT_ENDPOINT_DELETE"] = "conduit:endpoint:delete";
+    // ── Capture ─────────────────────────────────────────────────────────────
+    /**
+     * List and read captured requests, **including their raw bodies and headers**. Captures
+     * hold whatever a provider sent — order details, message contents, personal data — so
+     * this is closer to a data-export permission than a config one.
+     */
+    UserPermission["CONDUIT_CAPTURE_READ"] = "conduit:capture:read";
+    UserPermission["CONDUIT_CAPTURE_DELETE"] = "conduit:capture:delete";
+    // ── Replay ──────────────────────────────────────────────────────────────
+    /**
+     * Resend a captured request to an arbitrary URL. Separate from `CONDUIT_CAPTURE_READ`
+     * because it makes an outbound request from our infrastructure with a body the caller
+     * controls, which is a materially different power from reading a row.
+     */
+    UserPermission["CONDUIT_REPLAY_EXECUTE"] = "conduit:replay:execute";
+    // ── Provider ────────────────────────────────────────────────────────────
+    UserPermission["CONDUIT_PROVIDER_READ"] = "conduit:provider:read";
+    /** Define or amend a custom provider manifest — signature scheme, headers, handshake. */
+    UserPermission["CONDUIT_PROVIDER_MANAGE"] = "conduit:provider:manage";
+})(UserPermission || (UserPermission = {}));
+/**
+ * Every member, for seeding the owner role and validating custom-role input.
+ *
+ * Frozen because it is shared mutable state in a browser bundle otherwise: one caller sorting
+ * it in place reorders it for everyone.
+ */
+export const ALL_USER_PERMISSIONS = Object.freeze(Object.values(UserPermission));
+//# sourceMappingURL=user-permission.enum.js.map

package/dist/esm/enum/user-permission.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-permission.enum.js","sourceRoot":"","sources":["../../../src/enum/user-permission.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAN,IAAY,cAkEX;AAlED,WAAY,cAAc;IACtB,4EAA4E;IAE5E,2EAA2E;IAC3E,6CAA2B,CAAA;IAC3B,iDAA+B,CAAA;IAC/B,sFAAsF;IACtF,iDAA+B,CAAA;IAE/B,2EAA2E;IAC3E,yCAAuB,CAAA;IACvB,6CAA2B,CAAA;IAC3B,6CAA2B,CAAA;IAC3B,6CAA2B,CAAA;IAE3B,2EAA2E;IAC3E,qDAAmC,CAAA;IACnC,6EAA6E;IAC7E,yDAAuC,CAAA;IACvC;;;OAGG;IACH,mEAAiD,CAAA;IAEjD,2EAA2E;IAC3E,yCAAuB,CAAA;IACvB,6CAA2B,CAAA;IAC3B,6CAA2B,CAAA;IAC3B,6CAA2B,CAAA;IAE3B,2EAA2E;IAC3E,+CAA6B,CAAA;IAC7B,iDAA+B,CAAA;IAC/B,mDAAiC,CAAA;IAEjC,4EAA4E;IAE5E,2EAA2E;IAC3E,qEAAqE;IACrE,iEAA+C,CAAA;IAC/C,qEAAmD,CAAA;IACnD,qEAAmD,CAAA;IACnD,qEAAmD,CAAA;IAEnD,2EAA2E;IAC3E;;;;OAIG;IACH,+DAA6C,CAAA;IAC7C,mEAAiD,CAAA;IAEjD,2EAA2E;IAC3E;;;;OAIG;IACH,mEAAiD,CAAA;IAEjD,2EAA2E;IAC3E,iEAA+C,CAAA;IAC/C,yFAAyF;IACzF,qEAAmD,CAAA;AACvD,CAAC,EAlEW,cAAc,KAAd,cAAc,QAkEzB;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA8B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC"}

package/dist/esm/type/api-response.type.d.ts

@@ -1,18 +1,5 @@
 import type { ErrorCode } from '../enum/error-code.enum.js';
 import type { Maybe } from './nil.type.js';
-/**
- * Envelope for a successful HTTP response.
- *
- * Every service wraps its payload in this shape, so a client can branch on
- * `success` before touching anything else and never has to guess whether a
- * 200 body is data or an error report.
- *
- * @typeParam T - the response payload type.
- */
-export interface ApiSuccessResponse<T> {
-    success: true;
-    data: T;
-}
 /**
  * The error half of {@link ApiErrorResponse}.
  *
@@ -36,8 +23,30 @@ export interface ApiErrorBody {
     correlationId?: Maybe<string>;
 }
 /**
- * Envelope for a failed HTTP response, emitted by the SDK's global exception
- * filter for every non-2xx status.
+ * Envelope for a failed response, emitted by the SDK's `GlobalExceptionFilter` for every
+ * non-2xx status.
+ *
+ * **Only errors are enveloped.** A success is the bare payload — a tenant response *is* a
+ * tenant, not a `{ success, data }` wrapper around one. So `success: false` discriminates a
+ * shape the client receives *instead of* its payload, never alongside it:
+ *
+ * ```ts
+ * const body: unknown = await response.json();
+ *
+ * if (!response.ok) {
+ *     throw new ApiError(body as ApiErrorResponse);
+ * }
+ *
+ * return body as Tenant;
+ * ```
+ *
+ * This file also declared `ApiSuccessResponse<T>` and a union over the two until 0.3.0.
+ * Nothing ever sent it: both `iveri-identity-api` and `conduit-api` register the exception
+ * filter and no success interceptor. A type describing a response no service produces is worse
+ * than no type at all — reading it, the natural thing to write is `body.data`, which is
+ * `undefined` for every call in the application. It was removed rather than made true, because
+ * bare payloads were already shipped across two services and a frontend and the envelope added
+ * nothing to the HTTP status a client must check regardless.
  */
 export interface ApiErrorResponse {
     success: false;
@@ -47,17 +56,4 @@ export interface ApiErrorResponse {
     /** Request path that produced the error, without the query string. */
     path: string;
 }
-/**
- * Discriminated union of both envelopes. Narrow on `success`:
- *
- * ```ts
- * if (!response.success) {
- *     return handle(response.error.code);
- * }
- * use(response.data);
- * ```
- *
- * @typeParam T - the payload type on the success branch.
- */
-export type ApiResponse<T> = ApiSuccessResponse<T> | ApiErrorResponse;
 //# sourceMappingURL=api-response.type.d.ts.map

package/dist/esm/type/api-response.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-response.type.d.ts","sourceRoot":"","sources":["../../../src/type/api-response.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACjC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;CACX;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IACzB,iFAAiF;IACjF,IAAI,EAAE,SAAS,CAAC;IAEhB,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEzC;;;OAGG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,YAAY,CAAC;IAEpB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAElB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC"}
+{"version":3,"file":"api-response.type.d.ts","sourceRoot":"","sources":["../../../src/type/api-response.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IACzB,iFAAiF;IACjF,IAAI,EAAE,SAAS,CAAC;IAEhB,kFAAkF;IAClF,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEzC;;;OAGG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,YAAY,CAAC;IAEpB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAElB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;CAChB"}

package/dist/esm/type/index.d.ts

@@ -1,5 +1,6 @@
 export * from './api-response.type.js';
 export * from './cursor-page.type.js';
+export * from './iso-date-time.type.js';
 export * from './nil.type.js';
 export * from './paginated.type.js';
 export * from './uuid.type.js';

package/dist/esm/type/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/type/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/type/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}

package/dist/esm/type/index.js

@@ -1,5 +1,6 @@
 export * from './api-response.type.js';
 export * from './cursor-page.type.js';
+export * from './iso-date-time.type.js';
 export * from './nil.type.js';
 export * from './paginated.type.js';
 export * from './uuid.type.js';

package/dist/esm/type/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/type/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/type/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC"}

package/dist/esm/type/iso-date-time.type.d.ts

@@ -0,0 +1,17 @@
+/**
+ * An ISO-8601 timestamp as it appears on the wire: `2026-08-02T09:41:17.312Z`.
+ *
+ * **JSON has no date type**, so every timestamp a service sends is a string, whatever the
+ * entity behind it holds. Naming that is not pedantry — it is the single most reliable way to
+ * hand-retype a backend response wrongly. A frontend interface declaring `receivedAt: Date`
+ * compiles, and every `receivedAt.getTime()` throws at runtime against a value that is really
+ * a string. `conduit-admin-web` called this out in a comment and got it right by hand; the
+ * point of putting the shapes in this package is that nobody has to.
+ *
+ * It is an alias, not a branded type, deliberately. A brand would force a cast at every
+ * boundary where a string arrives from `JSON.parse` — which is all of them — and buy nothing,
+ * since the value genuinely is an unvalidated string until someone parses it. What this alias
+ * carries is the instruction: to get a `Date`, write `new Date(value)`.
+ */
+export type IsoDateTime = string;
+//# sourceMappingURL=iso-date-time.type.d.ts.map

package/dist/esm/type/iso-date-time.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iso-date-time.type.d.ts","sourceRoot":"","sources":["../../../src/type/iso-date-time.type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC"}

package/dist/esm/type/iso-date-time.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=iso-date-time.type.js.map

package/dist/esm/type/iso-date-time.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iso-date-time.type.js","sourceRoot":"","sources":["../../../src/type/iso-date-time.type.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iveri/contracts",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Wire contracts shared by every Iveri backend and frontend. Zero runtime dependencies.",
   "license": "MIT",
   "repository": {
@@ -24,8 +24,28 @@
       "import": "./dist/esm/index.js",
       "require": "./dist/cjs/index.js"
     },
+    "./conduit": {
+      "types": "./dist/cjs/api/conduit/index.d.ts",
+      "import": "./dist/esm/api/conduit/index.js",
+      "require": "./dist/cjs/api/conduit/index.js"
+    },
+    "./identity": {
+      "types": "./dist/cjs/api/identity/index.d.ts",
+      "import": "./dist/esm/api/identity/index.js",
+      "require": "./dist/cjs/api/identity/index.js"
+    },
     "./package.json": "./package.json"
   },
+  "typesVersions": {
+    "*": {
+      "conduit": [
+        "./dist/cjs/api/conduit/index.d.ts"
+      ],
+      "identity": [
+        "./dist/cjs/api/identity/index.d.ts"
+      ]
+    }
+  },
   "sideEffects": false,
   "files": [
     "dist",
@@ -33,7 +53,7 @@
   ],
   "scripts": {
     "clean": "rimraf dist tsconfig.*.tsbuildinfo",
-    "build": "pnpm clean && tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json && node ./scripts/write-dist-package-json.mjs && node ./scripts/verify-zero-runtime-deps.mjs",
+    "build": "pnpm clean && tsc -p tsconfig.cjs.json && tsc -p tsconfig.esm.json && node ./scripts/write-dist-package-json.mjs && node ./scripts/verify-zero-runtime-deps.mjs && node ./scripts/verify-entry-points.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "jest",
     "lint": "eslint .",