@endora-commerce/contracts 0.100.0

package/dist/environment-inputs.js

@@ -0,0 +1,277 @@
+/**
+ * The environment-input declaration — what a running Endora needs, said once.
+ *
+ * Normative: `specs/117-instance-bring-up/contracts/environment-inputs.md`
+ * §1–§2, FR-001 and FR-005.
+ *
+ * ## Why the shape lives here
+ *
+ * Three programs read a declaration and none of them may author a second copy
+ * of it (D-100): `endora new instance` and `endora new storefront` (which
+ * values to resolve and write), `endora doctor` (which values to require and
+ * what their absence costs), and the reconciliation check. Four *authors*
+ * write one — the platform, each application, and every module in its own
+ * manifest — so the shape is a contract before it is anybody's data, which is
+ * what `packages/contracts` is for.
+ *
+ * ## `describes` carries both languages inline, and that is a decision
+ *
+ * §R1.1 puts this prose in the translation boundary's case 1 — the reader's
+ * language is resolvable when the sentence is composed — and says a module's
+ * ships in its own bundle. **A bundle is not reachable here.** The first
+ * reader is a CLI on a client's machine: it loads no `_i18n` reconciler, has
+ * no settings store to ask, and the *platform's* inputs have no owning
+ * module whose bundle they could sit in. So the sentence ships as `{ en, pl }`
+ * on the declaration itself, which satisfies the owner's translation policy
+ * (English by default, a Polish bundle beside it, English as the fallback)
+ * with the one mechanism a standalone program can read. The check holds both
+ * languages to a non-empty sentence, so a single-language declaration is a
+ * finding rather than a silent English-only input.
+ *
+ * ## There is deliberately no `default` field
+ *
+ * §R1.3. A declaration that could carry a default would become the seventieth
+ * home of an invented value, blessed by a contract — which is the exact thing
+ * the provenance line's `defaulted=0` exists to make impossible. The absence
+ * is load-bearing, not an omission.
+ *
+ * ## `consumers` scopes `requirement`; it does not merely describe it
+ *
+ * `specs/118-instance-member-selection/` establishes that an instance may
+ * deliberately omit a member — its admin being the ruled case (D-215). That
+ * member is absent when the operator declines it, or when
+ * `@endora-commerce/admin-shell` does not **resolve** at the version being
+ * installed (`specs/110-instance-repository/contracts/instance-tree.md` §2.4).
+ * This comment read *"while `@endora-commerce/admin-shell` does not exist"*
+ * until 2026-09-13, by which time `packages/admin-shell` did — a premise about
+ * the tree, written into a source file where nothing re-derives it. An input
+ * no written member reads is not "required and missing"; it is **not in this
+ * run's population at all**, which is what keeps the provenance line to four
+ * outcomes instead of five.
+ *
+ * **Scope by declared consumer, never by name.** Measured on this tree, the
+ * name-based rule is wrong on two of the three inputs that mention the admin:
+ *
+ *   * `VITE_API_BASE_URL` — read by `admin/src` alone. Dropped with the
+ *     member.
+ *   * `ADMIN_BASE_URL` — read by the **backend** (`mfa`, when it composes the
+ *     links it mails). Its *value* names the admin; its consumer is the
+ *     backend, and it matters **more** when the admin is on another host.
+ *   * `CORS_ALLOWED_ORIGINS` — read by the backend
+ *     (`packages/platform/src/http/server.ts`), and its value has to name the
+ *     admin's origin for the admin to work at all.
+ *
+ * Two of those three would be dropped by any rule keyed on the spelling.
+ */
+import { z } from 'zod';
+/**
+ * The trees that read an environment value.
+ *
+ * A value read by more than one is a value those trees must **agree** about,
+ * and under D-195 and D-207 two of the three are the client's own
+ * repositories — so the agreement cannot be checked from inside any one of
+ * them. That is `environment-inputs.md` §5's subject and the derivation is
+ * this field, never a table (R5.1, R5.4).
+ */
+export const ENVIRONMENT_CONSUMERS = ['backend', 'admin', 'storefront'];
+export const EnvironmentConsumerSchema = z.enum(ENVIRONMENT_CONSUMERS);
+/**
+ * A sentence in every language the platform ships, on the declaration itself.
+ *
+ * See the header for why this is not a bundle key. Both members are required:
+ * "ships `en` and `pl`" enforced by the type rather than by anybody
+ * remembering, in the idiom the storefront's own `Record<MessageKey, string>`
+ * uses.
+ */
+export const LocalizedSentenceSchema = z.object({
+    en: z.string().min(1),
+    pl: z.string().min(1),
+});
+/**
+ * Required, conditionally required, or optional — and the middle term is the
+ * one that matters (§R1.2).
+ *
+ * `requiredWhen` is a predicate over **another input**: `MEILISEARCH_URL` is
+ * required iff `CATALOG_SEARCH_BACKEND=meilisearch`, and without the predicate
+ * a doctor would demand a service two thirds of deployments do not run.
+ *
+ * `optional` carries **what is lost**, never the word "optional". An operator
+ * deciding whether to set `SETTINGS_SECRET_ENCRYPTION_KEY` needs to read
+ * *"secret settings cannot be read or written"*, which is the fact; that the
+ * boot survives without it is not.
+ */
+export const EnvironmentRequirementSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('required') }),
+    z.object({
+        kind: z.literal('requiredWhen'),
+        /** The input the condition reads. Held to a declared name by the check. */
+        input: z.string().min(1),
+        /** The value of that input which makes this one required. */
+        equals: z.string().min(1),
+    }),
+    z.object({
+        kind: z.literal('optional'),
+        /** What the platform loses without it, in the operator's terms. */
+        without: LocalizedSentenceSchema,
+    }),
+]);
+/**
+ * Who declares the input, which is what `foreign-input` is asked against.
+ *
+ * A module declaring an input another module owns is two answers to one
+ * question waiting to disagree, so ownership is a field rather than an
+ * inference from where the file sits.
+ */
+export const EnvironmentInputOwnerSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('platform') }),
+    z.object({ kind: z.literal('application'), application: EnvironmentConsumerSchema }),
+    z.object({ kind: z.literal('module'), moduleId: z.string().min(1) }),
+]);
+/** One entry per environment variable a running platform reads (§1). */
+export const EnvironmentInputSchema = z.object({
+    /** The variable, verbatim. */
+    name: z.string().min(1),
+    /** One sentence: what it configures, in the operator's terms, not the code's. */
+    describes: LocalizedSentenceSchema,
+    requirement: EnvironmentRequirementSchema,
+    /** Whether the value must not be printed, logged or committed. */
+    secret: z.boolean(),
+    /**
+     * Whether a command may generate it (`input-resolution.md` §4).
+     *
+     * Permitted only where `secret` **and** where two correct values are
+     * interchangeable — the check refuses `generable` on a non-secret as
+     * `generable-without-secret`, and R4.5's judgement test (a URL, a name, a
+     * channel code, a hostname are never generable) is the author's.
+     */
+    generable: z.boolean(),
+    owner: EnvironmentInputOwnerSchema,
+    /** Which trees read it. Non-empty: an input nothing reads is a finding. */
+    consumers: z.array(EnvironmentConsumerSchema).min(1),
+    /**
+     * Which member of an instance this value is the **address of**, or `null`.
+     *
+     * Two programs ask *"which of these variables names the backend"* — `endora
+     * new storefront`, whose next step tells an author to point them at their
+     * backend, and the scaffold acceptance criterion, which points them at the
+     * backend it booted. Both used to answer it from the **shape of the value**
+     * in `.env.example`: *an absolute `http(s)` URL*. That predicate is only ever
+     * accidentally right. It cannot tell the backend's address from the
+     * storefront's own, from a CDN's or from an object store's, so the first
+     * URL-valued variable that is not a backend joins the set silently — and the
+     * next step then tells a client, in a file they own outright, that a variable
+     * "names the backend this storefront talks to" when it does not. A confident
+     * wrong sentence is worse than the silence it replaces.
+     *
+     * So it is declared rather than inferred, and the field is **required**: an
+     * author must answer it, and `EnvironmentInputSchema` refuses a declaration
+     * that does not — at `loadTreeDeclaration`, at `check:env-inputs`' fourth
+     * refusal, and in every other reader. An optional field would be forgotten
+     * exactly once, by the author of the next backend address, and nothing would
+     * say so.
+     *
+     * `null` is an answer and not an absence: this value is not the address of a
+     * member of this instance. A third party's address is `null` — `DATABASE_URL`
+     * and `REDIS_URL` are addresses, of a database and a cache, and neither is a
+     * member — because the question the two consumers ask is which of an
+     * *instance's own* parts a value points at. A list of origins is `null` too:
+     * `CORS_ALLOWED_ORIGINS` names several, and "the address of" is singular.
+     */
+    addressOf: EnvironmentConsumerSchema.nullable(),
+});
+/** A whole declaration, as an application or the platform publishes it. */
+export const EnvironmentInputsSchema = z.array(EnvironmentInputSchema);
+/**
+ * Is this input in the population of a run that writes exactly these members?
+ *
+ * The `specs/118-instance-member-selection/` scoping, as one predicate. An
+ * input whose declared consumers are all outside the written set is **out of
+ * the population**: not resolved, not prompted for, not counted, not refused.
+ *
+ * Reading it the other way — "required, and therefore missing" — is what would
+ * force a fifth provenance outcome, because such an input can be neither
+ * `defaulted` (there is nothing to invent) nor honestly reported as resolved.
+ */
+export function isReadByAnyOf(input, members) {
+    return input.consumers.some((consumer) => members.includes(consumer));
+}
+/**
+ * The declared inputs a run over these members actually has to answer for.
+ *
+ * Order is the declaration's, which is the order a prompt asks in
+ * (`input-resolution.md` §1: "in the declared order"). Sorting here would put
+ * the sequence in a comparator rather than in the hands of whoever wrote the
+ * declaration, and the first thing an operator is asked would then depend on
+ * an alphabet.
+ */
+export function scopeToMembers(inputs, members) {
+    return inputs.filter((input) => isReadByAnyOf(input, members));
+}
+/**
+ * Several authors' declarations, as the one population a reader has to answer.
+ *
+ * The four authors of `EnvironmentInput` are the platform, each application and
+ * every module in its own manifest, and nothing joins them: a scaffolded
+ * instance reads the platform's declaration **and** the manifest of every module
+ * it installed, and a doctor run against that instance reads the same pair. Two
+ * programs computing that join separately is two answers waiting to disagree,
+ * which is why the join is here rather than in either of them.
+ *
+ * **First author wins, and order is the first declaration's.** A name that
+ * migrates between authors is the case that happens — feature 121 moved
+ * `MEILISEARCH_URL` out of a module and into the platform, and a module may not
+ * describe a name the platform declares — so during such a move the platform's
+ * sentence is the one an operator reads, and the module's stale copy is shadowed
+ * rather than duplicated. Callers therefore pass the platform's declaration
+ * first. Across authors a shared name is expected and is **not** a finding;
+ * `check:env-inputs` says so, and this function is that rule's consequence
+ * rather than a second opinion about it.
+ */
+export function unionEnvironmentInputs(declarations) {
+    const merged = new Map();
+    for (const declaration of declarations) {
+        for (const input of declaration) {
+            if (!merged.has(input.name))
+                merged.set(input.name, input);
+        }
+    }
+    return [...merged.values()];
+}
+/**
+ * The variables whose value is the address of `member`, in declaration order.
+ *
+ * One derivation, because the two programs that ask are `endora new storefront`
+ * — telling an author which variables to point at their backend — and the
+ * acceptance criterion, which points those same variables at the backend it
+ * booted. Deriving it twice is two answers waiting to disagree, and that is not
+ * hypothetical: the criterion once configured `PUBLIC_API_BASE_URL`, a name no
+ * file in the storefront reads, and its boot assertion measured the compiled-in
+ * fallback for a whole investigation.
+ *
+ * The population is the declaration handed in, so it is the **copy's** answer
+ * about the copy — under D-195 a client's storefront is theirs, declaring what
+ * it reads — and never a list compiled into either program.
+ */
+export function addressVariablesFor(inputs, member) {
+    return inputs.filter((input) => input.addressOf === member).map((input) => input.name);
+}
+/**
+ * Is this input required, given what the rest of the environment holds?
+ *
+ * `requiredWhen` is resolved against the **resolved** values rather than
+ * against `process.env`, so a condition can be answered by a flag the operator
+ * has just supplied — which is the case that happens: a run that sets
+ * `CATALOG_SEARCH_BACKEND=meilisearch` on its command line must be asked for
+ * `MEILISEARCH_URL` in the same run, not in the next one.
+ */
+export function isRequiredGiven(input, values) {
+    switch (input.requirement.kind) {
+        case 'required':
+            return true;
+        case 'requiredWhen':
+            return values[input.requirement.input] === input.requirement.equals;
+        case 'optional':
+            return false;
+    }
+}
+//# sourceMappingURL=environment-inputs.js.map

package/dist/environment-inputs.js.map

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

package/dist/erp-connector.d.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+export declare const erpSyncJobStatusSchema: z.ZodEnum<{
+    error: "error";
+    success: "success";
+    pending: "pending";
+    in_progress: "in_progress";
+    poison: "poison";
+}>;
+export type ErpSyncJobStatus = z.infer<typeof erpSyncJobStatusSchema>;
+export declare const erpSyncJobDirectionSchema: z.ZodEnum<{
+    erp_to_shop: "erp_to_shop";
+    shop_to_erp: "shop_to_erp";
+}>;
+export type ErpSyncJobDirection = z.infer<typeof erpSyncJobDirectionSchema>;
+export declare const erpSyncIssueSeveritySchema: z.ZodEnum<{
+    error: "error";
+    info: "info";
+    warning: "warning";
+}>;
+export type ErpSyncIssueSeverity = z.infer<typeof erpSyncIssueSeveritySchema>;
+export declare const erpSyncRunSummarySchema: z.ZodObject<{
+    considered: z.ZodNumber;
+    succeeded: z.ZodNumber;
+    failed: z.ZodNumber;
+    skipped: z.ZodNumber;
+}, z.core.$strip>;
+export type ErpSyncRunSummary = z.infer<typeof erpSyncRunSummarySchema>;
+export declare const erpIdentityEntityTypeSchema: z.ZodEnum<{
+    order: "order";
+    quote_request: "quote_request";
+    article: "article";
+    contractor: "contractor";
+    offer: "offer";
+    sale_document: "sale_document";
+}>;
+export type ErpIdentityEntityType = z.infer<typeof erpIdentityEntityTypeSchema>;
+export declare const ERP_CONNECTOR_REGISTRY_PORT: "erpConnectorRegistryPort";
+/**
+ * Container name: `erpConnectorRegistryPort`. Owner: `erp_connector`.
+ *
+ * Mutual-exclusion registry among ERP connectors — see
+ * `specs/130-comarch-xl-sync/contracts/erp-connector-shared.md`.
+ */
+export interface ErpConnectorRegistryPort {
+    /** Refuses when another ERP connector's activation Setting is true. */
+    assertCanActivate(moduleId: string): Promise<void>;
+    recordActive(moduleId: string, adminId: string | null): Promise<void>;
+    clearActive(moduleId: string): Promise<void>;
+    getActiveModuleId(): Promise<string | null>;
+}
+export declare const ERP_CONNECTOR_ALREADY_ACTIVE: "ERP_CONNECTOR_ALREADY_ACTIVE";
+//# sourceMappingURL=erp-connector.d.ts.map

package/dist/erp-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"erp-connector.d.ts","sourceRoot":"","sources":["../src/erp-connector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;EAMjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,yBAAyB;;;EAAyC,CAAC;AAChF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,0BAA0B;;;;EAAuC,CAAC;AAC/E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,uBAAuB;;;;;iBAKlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,2BAA2B;;;;;;;EAOtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,2BAA2B,EAAG,0BAAmC,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,uEAAuE;IACvE,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,iBAAiB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC7C;AASD,eAAO,MAAM,4BAA4B,EAAG,8BAAuC,CAAC"}

package/dist/erp-connector.js

@@ -0,0 +1,34 @@
+// Shared ERP connector vocabulary — feature 119 (`erp_connector` package).
+import { z } from 'zod';
+export const erpSyncJobStatusSchema = z.enum([
+    'pending',
+    'in_progress',
+    'success',
+    'error',
+    'poison',
+]);
+export const erpSyncJobDirectionSchema = z.enum(['erp_to_shop', 'shop_to_erp']);
+export const erpSyncIssueSeveritySchema = z.enum(['info', 'warning', 'error']);
+export const erpSyncRunSummarySchema = z.object({
+    considered: z.number().int().nonnegative(),
+    succeeded: z.number().int().nonnegative(),
+    failed: z.number().int().nonnegative(),
+    skipped: z.number().int().nonnegative(),
+});
+export const erpIdentityEntityTypeSchema = z.enum([
+    'article',
+    'contractor',
+    'order',
+    'quote_request',
+    'offer',
+    'sale_document',
+]);
+export const ERP_CONNECTOR_REGISTRY_PORT = 'erpConnectorRegistryPort';
+// Feature 132 — `ERP_CONNECTOR_MODULES` is **gone**, and this array is the one whose
+// deletion repairs a live Principle XV violation: a per-deployment **overlay** module
+// had to be written into this core file to join its family, because there was no
+// other way in. The family is declared by its members
+// (`capabilities: ['erp-connector']`) and derived by the platform; `erp_connector`
+// owns the key and mints the refusal code.
+export const ERP_CONNECTOR_ALREADY_ACTIVE = 'ERP_CONNECTOR_ALREADY_ACTIVE';
+//# sourceMappingURL=erp-connector.js.map

package/dist/erp-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"erp-connector.js","sourceRoot":"","sources":["../src/erp-connector.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,SAAS;IACT,aAAa;IACb,SAAS;IACT,OAAO;IACP,QAAQ;CACT,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC;AAGhF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;AAG/E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;CACxC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,IAAI,CAAC;IAChD,SAAS;IACT,YAAY;IACZ,OAAO;IACP,eAAe;IACf,OAAO;IACP,eAAe;CAChB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,2BAA2B,GAAG,0BAAmC,CAAC;AAgB/E,qFAAqF;AACrF,sFAAsF;AACtF,iFAAiF;AACjF,sDAAsD;AACtD,mFAAmF;AACnF,2CAA2C;AAE3C,MAAM,CAAC,MAAM,4BAA4B,GAAG,8BAAuC,CAAC"}