@endora-commerce/contracts 0.100.0

package/dist/organizations.d.ts.map

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

package/dist/organizations.js

@@ -0,0 +1,418 @@
+import { z } from 'zod';
+import { addressSnapshotSchema, isoDateTimeSchema, organizationRoleSchema, uuidSchema, } from './common.js';
+import { fulfilmentStrategySchema } from './inventory.js';
+import { foldDiacritics } from './text-normalization.js';
+/**
+ * Organizations, customer accounts, addresses, invitations — Source of truth
+ * per Principle V. Drives US2 + US3.
+ * See specs/001-b2b-platform-foundation/contracts/organizations.contract.md.
+ */
+// --- Primitives --------------------------------------------------------------
+/**
+ * Organization lifecycle status (feature 026 consolidation).
+ *
+ *  - `pending_verification` — newly registered, blocks transactions until
+ *    moderator approves (manual moderation mode) or auto-activated.
+ *  - `active` — may transact normally.
+ *  - `blocked` — operator-blocked (replaces the legacy `suspended`); the
+ *    Organization cannot place Orders or Quote Requests; reversible.
+ *  - `rejected` — moderator rejected at registration; terminal.
+ */
+export const organizationStatusSchema = z.enum([
+    'pending_verification',
+    'active',
+    'blocked',
+    'rejected',
+]);
+export const vatStatusSchema = z.enum(['vat_payer', 'vat_exempt', 'reverse_charge']);
+/**
+ * Feature 056 — per-organization credit-inheritance mode. Platform-admin only.
+ *
+ *  - `shared_pool` — a descendant with no own credit limit draws against the
+ *    nearest ancestor's pool; concurrent draws across the subtree are serialized
+ *    on the owning ancestor's row (zero double-spend).
+ *  - `independent_default` — the inherited amount is each descendant's own
+ *    effective limit; draws are independent of siblings.
+ *
+ * `null` on an Organization ⇒ fall back to the Settings global default
+ * (`organizations.hierarchy.credit_inheritance_mode`, factory `shared_pool`).
+ */
+export const creditInheritanceModeSchema = z.enum(['shared_pool', 'independent_default']);
+export const addressKindSchema = z.enum(['delivery', 'billing']);
+// --- Resources --------------------------------------------------------------
+export const organizationSchema = z.object({
+    id: uuidSchema,
+    name: z.string(),
+    taxId: z.string(),
+    status: organizationStatusSchema,
+    vatStatus: vatStatusSchema,
+    /** Feature 051 — true for a single-member personal (B2C) organization. */
+    isPersonal: z.boolean().optional(),
+    registeredAddress: addressSnapshotSchema.omit({ recipientName: true, phone: true }).extend({
+        recipientName: z.string().optional(),
+        phone: z.string().optional(),
+    }),
+    /**
+     * Organization-level override of the warehouse-picking (fulfilment) strategy
+     * used to reserve stock at order placement. `null` ⇒ inherit (sales-channel
+     * setting → platform default). When the strategy is `defined_order`,
+     * `fulfilmentStrategyWarehouseOrder` carries the ordered warehouse-id walk.
+     */
+    fulfilmentStrategy: fulfilmentStrategySchema.nullable().optional(),
+    fulfilmentStrategyWarehouseOrder: z.array(uuidSchema).nullable().optional(),
+    /**
+     * Feature 056 — hierarchy. `parentId` is the self-referential parent FK
+     * (`null` ⇒ root). `path` is the server-maintained materialized ancestor path
+     * (read-only). `creditInheritanceMode` is the per-org platform-admin override
+     * (`null` ⇒ global default). All three are additive; every pre-feature org is
+     * a root (`parentId = null`, `path = '/<id>/'`).
+     */
+    parentId: uuidSchema.nullable().optional(),
+    path: z.string().optional(),
+    creditInheritanceMode: creditInheritanceModeSchema.nullable().optional(),
+    createdAt: isoDateTimeSchema,
+    updatedAt: isoDateTimeSchema,
+});
+// --- Hierarchy (feature 056) ------------------------------------------------
+/**
+ * A single node in an organization subtree / ancestor chain. `depth` is the
+ * node's absolute depth in the tree (root = 0). Returned pre-order (subtree) or
+ * nearest-first (ancestors).
+ */
+export const organizationTreeNodeSchema = z.object({
+    id: uuidSchema,
+    name: z.string(),
+    parentId: uuidSchema.nullable(),
+    depth: z.number().int().nonnegative(),
+    status: organizationStatusSchema,
+});
+/** `GET /admin/organizations/:id/subtree` — descendants (incl. self), pre-order. */
+export const organizationSubtreeResponseSchema = z.object({
+    items: z.array(organizationTreeNodeSchema),
+});
+/** `GET /admin/organizations/:id/ancestors` — ancestor chain, nearest-first. */
+export const organizationAncestorsResponseSchema = z.object({
+    items: z.array(organizationTreeNodeSchema),
+});
+/**
+ * `POST /admin/organizations/:id/parent` — assign / move / detach parent.
+ * `parentId = null` makes `:id` a root. Path maintenance + cycle/depth checks
+ * are guaranteed server-side (this is the only writable path for `parentId`).
+ */
+export const assignOrganizationParentRequestSchema = z.object({
+    parentId: uuidSchema.nullable(),
+});
+/**
+ * `PUT /admin/organizations/:id/credit-inheritance-mode` — platform-admin only.
+ * `mode = null` ⇒ fall back to the Settings global default.
+ */
+export const setCreditInheritanceModeRequestSchema = z.object({
+    mode: creditInheritanceModeSchema.nullable(),
+});
+export const customerAccountSchema = z.object({
+    id: uuidSchema,
+    organizationId: uuidSchema,
+    email: z.string().email(),
+    firstName: z.string(),
+    lastName: z.string(),
+    role: organizationRoleSchema,
+    emailVerifiedAt: isoDateTimeSchema.nullable(),
+    twoFactorEnabled: z.boolean(),
+    createdAt: isoDateTimeSchema,
+    updatedAt: isoDateTimeSchema,
+});
+export const addressSchema = z.object({
+    id: uuidSchema,
+    organizationId: uuidSchema,
+    kind: addressKindSchema,
+    recipientName: z.string(),
+    street: z.string(),
+    city: z.string(),
+    postalCode: z.string(),
+    country: z.string().length(2),
+    phone: z.string().nullable().optional(),
+    isDefault: z.boolean(),
+});
+// --- Requests --------------------------------------------------------------
+/** Polish NIP or a generic tax-id string; exact validation lives in the backend. */
+const taxIdSchema = z.string().min(8).max(32);
+export const registerOrganizationRequestSchema = z.object({
+    organization: z.object({
+        name: z.string().min(1).max(255),
+        taxId: taxIdSchema,
+        registeredAddress: z.object({
+            street: z.string().min(1).max(255),
+            city: z.string().min(1).max(120),
+            postalCode: z.string().min(1).max(20),
+            country: z.string().length(2),
+        }),
+        vatStatus: vatStatusSchema.optional(),
+    }),
+    firstUser: z.object({
+        email: z.string().email(),
+        password: z.string().min(12).max(256),
+        firstName: z.string().min(1).max(120),
+        lastName: z.string().min(1).max(120),
+    }),
+    acceptedTermsVersion: z.string(),
+});
+export const emailVerificationRequestSchema = z.object({
+    token: z.string().min(10),
+});
+export const passwordResetRequestSchema = z.object({
+    email: z.string().email(),
+});
+export const passwordResetConfirmSchema = z.object({
+    token: z.string().min(10),
+    newPassword: z.string().min(12).max(256),
+});
+export const customerLoginRequestSchema = z.object({
+    email: z.string().email(),
+    password: z.string(),
+});
+/**
+ * Outcome of the anonymous-cart → customer-cart merge that runs inside the
+ * customer-login flow (feature 037-cart-merge-on-login).
+ *
+ * Internal shape — split between two `noop_*` variants so the audit /
+ * observability paths can distinguish "anon cart was empty" from "no anon
+ * cart was supplied". The HTTP-facing shape collapses both into a single
+ * `'noop'`; see `cartMergeOutcomePublicSchema` below.
+ */
+export const cartMergeOutcomeSchema = z.object({
+    outcome: z.enum(['adopted', 'merged', 'noop_empty', 'noop_no_anon']),
+    movedLineCount: z.number().int().min(0),
+    summedLineCount: z.number().int().min(0),
+    destinationCartId: uuidSchema,
+});
+/**
+ * Public (HTTP) narrowing of `cartMergeOutcomeSchema`. The storefront only
+ * needs three buckets to decide whether to surface the merge-confirmation
+ * toast (`adopted | merged → toast`, `noop → silent`) and the destination
+ * cart id for the next cart read.
+ */
+export const cartMergeOutcomePublicSchema = z.object({
+    outcome: z.enum(['adopted', 'merged', 'noop']),
+    destinationCartId: uuidSchema,
+});
+/**
+ * Customer login response. The `cartMerge` field is populated when the
+ * login carries an anonymous-cart cookie; `null` when no anon cookie was
+ * supplied; `outcome: 'noop'` when the cookie was supplied but had no
+ * observable effect (no anon cart, or the anon cart was empty).
+ */
+export const customerLoginResponseSchema = z.object({
+    data: z.object({
+        customerAccount: z.object({
+            id: uuidSchema,
+            email: z.string().email(),
+            organizationId: uuidSchema.nullable(),
+            role: organizationRoleSchema,
+            twoFactorEnabled: z.boolean(),
+        }),
+        cartMerge: cartMergeOutcomePublicSchema.nullable().optional(),
+    }),
+});
+export const changePasswordRequestSchema = z.object({
+    currentPassword: z.string(),
+    newPassword: z.string().min(12).max(256),
+});
+export const createAddressRequestSchema = z.object({
+    kind: addressKindSchema,
+    recipientName: z.string().min(1).max(160),
+    street: z.string().min(1).max(255),
+    city: z.string().min(1).max(120),
+    postalCode: z.string().min(1).max(20),
+    country: z.string().length(2),
+    phone: z.string().max(32).optional(),
+    isDefault: z.boolean().optional(),
+});
+export const updateAddressRequestSchema = createAddressRequestSchema.partial();
+export const inviteMemberRequestSchema = z.object({
+    email: z.string().email(),
+    role: organizationRoleSchema.optional(),
+});
+export const acceptInvitationRequestSchema = z.object({
+    password: z.string().min(12),
+    firstName: z.string().min(1).max(120),
+    lastName: z.string().min(1).max(120),
+});
+export const changeMemberRoleRequestSchema = z.object({
+    role: organizationRoleSchema,
+});
+/** Platform admin — PATCH `/admin/organizations/:id` */
+export const adminPatchOrganizationRequestSchema = z.object({
+    name: z.string().min(1).max(255).optional(),
+    vatStatus: vatStatusSchema.optional(),
+    status: organizationStatusSchema.optional(),
+    /** Feature 038 (US4) — additional emails CC'd on this org's order confirmations. */
+    orderConfirmationEmails: z.array(z.string()).optional(),
+    /**
+     * Organization-level fulfilment-strategy override. `null` clears the
+     * override (inherit channel setting → platform default). `defined_order`
+     * pairs with `fulfilmentStrategyWarehouseOrder` (ordered warehouse ids).
+     */
+    fulfilmentStrategy: fulfilmentStrategySchema.nullable().optional(),
+    fulfilmentStrategyWarehouseOrder: z.array(uuidSchema).nullable().optional(),
+    /** Feature 055 — custom-field values for this organization (validated on write). */
+    customFieldValues: z.record(z.string(), z.unknown()).optional(),
+    expectedUpdatedAt: z.string().optional(),
+});
+/** Platform admin — POST `/admin/organizations/:id/recover-admin-access` */
+export const adminRecoverOrgAccessRequestSchema = z.object({
+    promoteCustomerAccountId: uuidSchema,
+});
+/** Platform admin — POST `/admin/organizations/:id/members` (direct create) */
+export const adminDirectMemberRequestSchema = z.object({
+    email: z.string().email(),
+    firstName: z.string().min(1).max(120),
+    lastName: z.string().min(1).max(120),
+    password: z.string().min(12).max(256),
+    role: organizationRoleSchema.optional(),
+});
+/** Platform admin — PATCH member role */
+export const adminPatchMemberRoleRequestSchema = z.object({
+    role: organizationRoleSchema,
+    expectedUpdatedAt: z.string().optional(),
+});
+/**
+ * Feature 056 (T032) — Platform admin — PATCH member roll-up capability.
+ * When enabled, this customer login sees/acts across its organization's subtree.
+ */
+export const adminSetMemberRollupRequestSchema = z.object({
+    subtreeRollupEnabled: z.boolean(),
+    expectedUpdatedAt: z.string().optional(),
+});
+/** Platform admin — PATCH `/admin/organizations/:id/members/:customerAccountId` (profile) */
+export const adminPatchMemberProfileRequestSchema = z
+    .object({
+    firstName: z.string().min(1).max(120).optional(),
+    lastName: z.string().min(1).max(120).optional(),
+    email: z.string().email().optional(),
+    expectedUpdatedAt: z.string().optional(),
+})
+    .refine((b) => b.firstName !== undefined || b.lastName !== undefined || b.email !== undefined, {
+    message: 'At least one of firstName, lastName, email is required',
+});
+// --- Responses (convenience) ------------------------------------------------
+export const registerOrganizationResponseSchema = z.object({
+    organization: organizationSchema,
+    customerAccount: customerAccountSchema,
+    emailVerificationSent: z.boolean(),
+});
+// --- Organization picker (feature 091, P2) ----------------------------------
+/**
+ * One row of the admin Organization picker.
+ *
+ * A **projection**, not the `GET /api/v1/admin/organizations` envelope: the
+ * picker renders a label, a status pill and nothing else, and it commits the
+ * `id`. `version` rides along because a caller that picks an Organization in
+ * order to write to it needs the optimistic-concurrency token it already had.
+ *
+ * Published because `@endora-commerce/admin-kit` builds this request itself
+ * (feature 091's P2 — the picker moved into the kit and rebuilt its call from
+ * the published `apiClient`), so the shape crosses a package boundary and
+ * Principle II puts it here. Before P2 it was declared in
+ * `admin/src/modules/organizations/api/organizations-picker-client.ts`, where a
+ * kit component could only reach it by importing a module's admin code.
+ *
+ * The status is `organizationStatusSchema` and not a picker-local enum: the four
+ * members the picker filters on are exactly that schema's, so a second name
+ * would be two spellings of one set with nothing keeping them equal.
+ */
+export const organizationPickerListItemSchema = z.object({
+    id: uuidSchema,
+    name: z.string(),
+    legalName: z.string().nullable(),
+    status: organizationStatusSchema,
+    countryCode: z.string().nullable().optional(),
+    salesRepAdminUserIds: z.array(uuidSchema).optional(),
+    memberCount: z.number().int().nonnegative().optional(),
+    version: z.number().int().nonnegative(),
+});
+/** One page of picker rows. `nextCursor` is `null` on the last page. */
+export const organizationPickerPageSchema = z.object({
+    items: z.array(organizationPickerListItemSchema),
+    nextCursor: z.string().nullable(),
+});
+// --- Sales-rep ↔ organization assignment (feature 008) ---------------------
+export const salesRepAssignmentSchema = z.object({
+    id: uuidSchema,
+    organizationId: uuidSchema,
+    adminUserId: uuidSchema,
+    displayName: z.string(),
+    email: z.string().email(),
+    assignedAt: isoDateTimeSchema,
+    assignedByAdminUserId: uuidSchema.nullable(),
+});
+export const assignSalesRepRequestSchema = z.object({
+    adminUserId: uuidSchema,
+});
+export const salesRepOrganizationSchema = z.object({
+    organizationId: uuidSchema,
+    name: z.string(),
+    openRfqCount: z.number().int().nonnegative(),
+    assignedAt: isoDateTimeSchema,
+});
+/**
+ * Diacritic-insensitive normalisation for the organisation's `name_search`
+ * column and for any query string matched against it.
+ *
+ * The character fold itself is `foldDiacritics` in `text-normalization.ts`,
+ * shared with `admin/` and reachable from `storefront/` (issue #240): it strips
+ * every Unicode combining mark through NFD decomposition and then maps the
+ * handful of precomposed Latin letters NFD does not decompose (notably Polish
+ * `ł`/`Ł`, Scandinavian `ø`/`Ø`, Croatian `đ`/`Đ`, Icelandic `ð`/`Ð`,
+ * `þ`/`Þ`, German `ß`, ligatures `æ` and `œ`). What is specific to an
+ * organisation name is the whitespace policy below, and only that: a name typed
+ * with a double space must match one stored with a single one.
+ *
+ * Published as a **function, not a port** (FR-013): it is pure over its
+ * argument, so switching `organizations` off does not change the answer, and a
+ * gated port answering 503 to "fold these diacritics" would be a bug. The
+ * entity's `@BeforeCreate` / `@BeforeUpdate` hooks and `orders`' list filter
+ * both call it, and they must agree or the filter silently stops matching.
+ *
+ * That agreement is why the fold is characterised rather than merely tested:
+ * `backend/test/unit/organizations/name-search-fold-characterisation.test.ts`
+ * pins the output for every input this function can meet, because a change here
+ * re-folds nothing already written to `name_search` and reports no error when
+ * the two stop agreeing.
+ *
+ * Node natives only (Principle IV).
+ */
+export function normalizeOrganizationName(input) {
+    return foldDiacritics(input).replace(/\s+/g, ' ').trim();
+}
+/**
+ * Thrown when the organisation a read names does not exist. The kernel's
+ * `OrganizationReadPort` has documented it as `assertCanTransact`'s failure
+ * mode since D-32 while the class itself lived in a module, which is the gap
+ * this publication closes.
+ */
+export class OrganizationNotFoundError extends Error {
+    organizationId;
+    constructor(organizationId) {
+        super(`Organization ${organizationId} not found.`);
+        this.organizationId = organizationId;
+        this.name = 'OrganizationNotFoundError';
+    }
+}
+/**
+ * Thrown when a write is attempted for an organisation whose status forbids
+ * transacting. Four modules — `carts`, `orders`, `quote_requests` and the
+ * external order intake — catch it by class to turn it into a 409 envelope,
+ * which is why it is published here rather than being a port: an error is a
+ * shape, and `DictionaryReferenceError` in `dictionary.ts` set the precedent.
+ */
+export class OrganizationCannotTransactError extends Error {
+    organizationId;
+    status;
+    constructor(organizationId, status) {
+        super(`Organization ${organizationId} cannot transact in status '${status}'.`);
+        this.organizationId = organizationId;
+        this.status = status;
+        this.name = 'OrganizationCannotTransactError';
+    }
+}
+//# sourceMappingURL=organizations.js.map

package/dist/organizations.js.map

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

package/dist/pagination.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+/**
+ * Cursor-based pagination payload — see
+ * specs/001-b2b-platform-foundation/contracts/README.md.
+ *
+ * Offset pagination is deliberately rejected because it degrades on large catalogs (R-08).
+ */
+export declare const paginationSchema: z.ZodObject<{
+    cursor: z.ZodNullable<z.ZodString>;
+    hasMore: z.ZodBoolean;
+    limit: z.ZodNumber;
+}, z.core.$strip>;
+export type Pagination = z.infer<typeof paginationSchema>;
+/** Shared query parameters for every list endpoint. */
+export declare const listQuerySchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    cursor: z.ZodOptional<z.ZodString>;
+    sort: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ListQuery = z.infer<typeof listQuerySchema>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AAEH,eAAO,MAAM,gBAAgB;;;;iBAI3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,uDAAuD;AACvD,eAAO,MAAM,eAAe;;;;iBAI1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/pagination.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+/**
+ * Cursor-based pagination payload — see
+ * specs/001-b2b-platform-foundation/contracts/README.md.
+ *
+ * Offset pagination is deliberately rejected because it degrades on large catalogs (R-08).
+ */
+export const paginationSchema = z.object({
+    cursor: z.string().nullable().describe('opaque base64 cursor for the next page; null on last page'),
+    hasMore: z.boolean(),
+    limit: z.number().int().positive().max(200),
+});
+/** Shared query parameters for every list endpoint. */
+export const listQuerySchema = z.object({
+    limit: z.coerce.number().int().positive().max(200).default(50),
+    cursor: z.string().optional(),
+    sort: z.string().optional(),
+});
+// NOTE: cursor encode/decode helpers live in the backend (see backend/src/http/cursor.ts)
+// because Node's Buffer is not available in the browser and the frontends treat the cursor
+// as opaque.
+//# sourceMappingURL=pagination.js.map

package/dist/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../src/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;IACnG,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;CAC5C,CAAC,CAAC;AAIH,uDAAuD;AACvD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAIH,0FAA0F;AAC1F,2FAA2F;AAC3F,aAAa"}