@owlmeans/planning-postgres 0.1.18-rc.0

package/build/resource.js

@@ -0,0 +1,94 @@
+import { getDeclaration, makePostgresResource, PgIndexMethod, pgIdentifier } from '@owlmeans/postgres-resource';
+import { RES_PLANNING_CARD, RES_PLANNING_LINK, RES_PLANNING_SCHEMA, RES_PLANNING_TRANSITION } from './consts.js';
+import { PlanningCardTableSchema, PlanningLinkTableSchema, PlanningSchemaTableSchema, PlanningTransitionTableSchema, } from './schemas.js';
+/**
+ * Declare the indexes a maker owns — each only once. The declaration is keyed by alias at module
+ * scope, so a maker that runs twice (a target's maker wrapping this one, a spec) re-declaring an
+ * index would make the compiler warn about a duplicate on every boot.
+ */
+const declareIndexes = (resource, alias, indexes) => {
+    const table = pgIdentifier(alias);
+    const declared = getDeclaration(alias).indexes;
+    for (const [suffix, spec] of indexes) {
+        const name = `${table}_${suffix}`;
+        if (!declared.some(index => index.name === name)) {
+            resource.index(name, spec);
+        }
+    }
+};
+/** The index names a table carries, by suffix — what the store matches a unique violation on. */
+export const planningIndexName = (alias, suffix) => `${pgIdentifier(alias)}_${suffix}`;
+/**
+ * `planning-card` — projects, cards and specifications in ONE table, routed by `kind` at the query
+ * layer. Indexes follow the reads: a list by kind and type, children in order, membership
+ * (`parents`, GIN), a board by status, the intrinsic state by recency, labels (GIN), a code within
+ * its parent, and a slot's documents.
+ */
+export const makePlanningCardResource = (alias = RES_PLANNING_CARD, dbAlias, serviceAlias) => {
+    const resource = makePostgresResource(alias, dbAlias, serviceAlias);
+    resource.schema = PlanningCardTableSchema;
+    declareIndexes(resource, alias, [
+        ['entity_kind_type', { columns: ['entityId', 'kind', 'type'] }],
+        ['parent_order', { columns: ['parent', 'order'] }],
+        ['parents', { columns: ['parents'], method: PgIndexMethod.Gin }],
+        ['parent_status', { columns: ['parent', 'status'] }],
+        ['entity_intrinsic', { columns: ['entityId', 'intrinsic', 'updatedAt'] }],
+        ['labels', { columns: ['labels'], method: PgIndexMethod.Gin }],
+        ['code', { columns: ['entityId', 'parent', 'code'], where: '"code" IS NOT NULL' }],
+        ['slot', { columns: ['parent', 'category'], where: `"kind" = 'specification'` }],
+    ]);
+    return resource;
+};
+/**
+ * `planning-transition` — the append-only log. `(card, seq)` is the arbiter of allocation, a key is
+ * unique per organization, a project's history reads by time, and the pending rows by age (what
+ * `recover()` scans).
+ */
+export const makePlanningTransitionResource = (alias = RES_PLANNING_TRANSITION, dbAlias, serviceAlias) => {
+    const resource = makePostgresResource(alias, dbAlias, serviceAlias);
+    resource.schema = PlanningTransitionTableSchema;
+    declareIndexes(resource, alias, [
+        ['card_seq', { columns: ['card', 'seq'], unique: true }],
+        ['entity_key', { columns: ['entityId', 'key'], unique: true, where: '"key" IS NOT NULL' }],
+        ['project_at', { columns: ['project', 'at'] }],
+        ['pending', { columns: ['at'], where: `("commit"->>'state') = 'pending'` }],
+    ]);
+    return resource;
+};
+/** `planning-link` — one row per `(from, to, type)`, read from either end, by type, and by project. */
+export const makePlanningLinkResource = (alias = RES_PLANNING_LINK, dbAlias, serviceAlias) => {
+    const resource = makePostgresResource(alias, dbAlias, serviceAlias);
+    resource.schema = PlanningLinkTableSchema;
+    declareIndexes(resource, alias, [
+        ['edge', { columns: ['from', 'to', 'type'], unique: true }],
+        ['inbound', { columns: ['to', 'type'] }],
+        ['entity_type', { columns: ['entityId', 'type'] }],
+        ['project', { columns: ['project'] }],
+    ]);
+    return resource;
+};
+/**
+ * `planning-schema` — data-defined types and flows, one row per `(organization, project layer,
+ * kind, key)`, plus each organization's private revision row (`kind: 'head'`).
+ */
+export const makePlanningSchemaResource = (alias = RES_PLANNING_SCHEMA, dbAlias, serviceAlias) => {
+    const resource = makePostgresResource(alias, dbAlias, serviceAlias);
+    resource.schema = PlanningSchemaTableSchema;
+    declareIndexes(resource, alias, [
+        ['scope', { unique: true, expression: `"entityId", COALESCE("project", ''), "kind", "key"` }],
+        ['rev', { columns: ['entityId', 'rev'] }],
+    ]);
+    return resource;
+};
+export const makePlanningCardPostgres = (dbAlias, serviceAlias) => makePlanningCardResource(RES_PLANNING_CARD, dbAlias, serviceAlias);
+export const makePlanningTransitionPostgres = (dbAlias, serviceAlias) => makePlanningTransitionResource(RES_PLANNING_TRANSITION, dbAlias, serviceAlias);
+export const makePlanningLinkPostgres = (dbAlias, serviceAlias) => makePlanningLinkResource(RES_PLANNING_LINK, dbAlias, serviceAlias);
+export const makePlanningSchemaPostgres = (dbAlias, serviceAlias) => makePlanningSchemaResource(RES_PLANNING_SCHEMA, dbAlias, serviceAlias);
+/** The four resources under the aliases a store resolves — what `appendPostgresPlanning` registers. */
+export const makePlanningPostgresResources = (aliases, dbAlias, serviceAlias) => [
+    makePlanningCardResource(aliases.card, dbAlias, serviceAlias),
+    makePlanningTransitionResource(aliases.transition, dbAlias, serviceAlias),
+    makePlanningLinkResource(aliases.link, dbAlias, serviceAlias),
+    makePlanningSchemaResource(aliases.schema, dbAlias, serviceAlias),
+];
+//# sourceMappingURL=resource.js.map

package/build/resource.js.map

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

package/build/schemas.d.ts

@@ -0,0 +1,20 @@
+import type { Relationship, Transition } from '@owlmeans/planning';
+import type { JSONSchemaType } from 'ajv';
+import type { PlanningCardRecord, PlanningSchemaRow } from './types.js';
+/**
+ * `planning-card`: projects, cards and specifications in one table — derived from
+ * `AnyWorkcardSchema`, plus the private `headAt` column. `seq`/`head`/`revision`/`bodyChars` are
+ * `integer`, `body` is `text`, every timestamp is `text`.
+ */
+export declare const PlanningCardTableSchema: JSONSchemaType<PlanningCardRecord>;
+/** `planning-transition`: the append-only log, derived from `TransitionSchema`. */
+export declare const PlanningTransitionTableSchema: JSONSchemaType<Transition>;
+/** `planning-link`: typed edges, derived from `RelationshipSchema`. */
+export declare const PlanningLinkTableSchema: JSONSchemaType<Relationship>;
+/**
+ * `planning-schema`: data-defined types and flows, derived from `ScopedSchemaRecordSchema`. `kind`
+ * also admits the private `head` row an organization's revision is counted in; `project` is `text`
+ * so the uniqueness expression `COALESCE("project", '')` stays one type.
+ */
+export declare const PlanningSchemaTableSchema: JSONSchemaType<PlanningSchemaRow>;
+//# sourceMappingURL=schemas.d.ts.map

package/build/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AA2BvE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,oCAWH,CAAA;AAIjC,mFAAmF;AACnF,eAAO,MAAM,6BAA6B,4BAIV,CAAA;AAIhC,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,8BAGF,CAAA;AAIlC;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,mCAQE,CAAA"}

package/build/schemas.js

@@ -0,0 +1,64 @@
+import { AnyWorkcardSchema, PlanningSchemaKind, RelationshipSchema, ScopedSchemaRecordSchema, TransitionSchema, } from '@owlmeans/planning';
+import { SCHEMA_HEAD_KIND } from './consts.js';
+const propertiesOf = (schema) => structuredClone(schema.properties);
+const requiredOf = (schema) => [...(schema.required ?? [])];
+/**
+ * An ISO-8601 timestamp stays TEXT. The record's `format: 'date-time'` would compile to
+ * `timestamptz` and marshal through `Date` — which changes the string a record carries and breaks
+ * the lexicographic order every `updatedSince`, `at` sort and gap age relies on.
+ */
+const timestamp = (property) => {
+    const { format: _format, ...rest } = property;
+    return { ...rest, pg: { type: 'text' } };
+};
+const integer = (property) => ({ ...property, pg: { type: 'integer' } });
+const tableSchema = (properties, required) => ({
+    type: 'object', properties, required, additionalProperties: false,
+});
+const cardProperties = propertiesOf(AnyWorkcardSchema);
+/**
+ * `planning-card`: projects, cards and specifications in one table — derived from
+ * `AnyWorkcardSchema`, plus the private `headAt` column. `seq`/`head`/`revision`/`bodyChars` are
+ * `integer`, `body` is `text`, every timestamp is `text`.
+ */
+export const PlanningCardTableSchema = tableSchema({
+    ...cardProperties,
+    createdAt: timestamp(cardProperties.createdAt),
+    updatedAt: timestamp(cardProperties.updatedAt),
+    closedAt: timestamp(cardProperties.closedAt),
+    seq: integer(cardProperties.seq),
+    head: integer(cardProperties.head),
+    revision: integer(cardProperties.revision),
+    bodyChars: integer(cardProperties.bodyChars),
+    body: { ...cardProperties.body, pg: { type: 'text' } },
+    headAt: { type: 'string', nullable: true, pg: { type: 'text' } },
+}, requiredOf(AnyWorkcardSchema));
+const transitionProperties = propertiesOf(TransitionSchema);
+/** `planning-transition`: the append-only log, derived from `TransitionSchema`. */
+export const PlanningTransitionTableSchema = tableSchema({
+    ...transitionProperties,
+    seq: integer(transitionProperties.seq),
+    at: timestamp(transitionProperties.at),
+}, requiredOf(TransitionSchema));
+const linkProperties = propertiesOf(RelationshipSchema);
+/** `planning-link`: typed edges, derived from `RelationshipSchema`. */
+export const PlanningLinkTableSchema = tableSchema({
+    ...linkProperties,
+    createdAt: timestamp(linkProperties.createdAt),
+}, requiredOf(RelationshipSchema));
+const schemaProperties = propertiesOf(ScopedSchemaRecordSchema);
+/**
+ * `planning-schema`: data-defined types and flows, derived from `ScopedSchemaRecordSchema`. `kind`
+ * also admits the private `head` row an organization's revision is counted in; `project` is `text`
+ * so the uniqueness expression `COALESCE("project", '')` stays one type.
+ */
+export const PlanningSchemaTableSchema = tableSchema({
+    ...schemaProperties,
+    kind: { type: 'string', enum: [...Object.values(PlanningSchemaKind), SCHEMA_HEAD_KIND] },
+    project: { ...schemaProperties.project, pg: { type: 'text' } },
+    version: integer(schemaProperties.version),
+    rev: integer(schemaProperties.rev),
+    createdAt: timestamp(schemaProperties.createdAt),
+    updatedAt: timestamp(schemaProperties.updatedAt),
+}, requiredOf(ScopedSchemaRecordSchema));
+//# sourceMappingURL=schemas.js.map

package/build/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,gBAAgB,GACtG,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAK9C,MAAM,YAAY,GAAG,CAAC,MAAc,EAAc,EAAE,CAClD,eAAe,CAAE,MAAqC,CAAC,UAAU,CAAC,CAAA;AAEpE,MAAM,UAAU,GAAG,CAAC,MAAc,EAAY,EAAE,CAAC,CAAC,GAAG,CAAE,MAAkC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAA;AAE1G;;;;GAIG;AACH,MAAM,SAAS,GAAG,CAAC,QAAiC,EAA2B,EAAE;IAC/E,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAA;IAC7C,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;AAC1C,CAAC,CAAA;AAED,MAAM,OAAO,GAAG,CAAC,QAAiC,EAA2B,EAAE,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC,CAAA;AAE1H,MAAM,WAAW,GAAG,CAAI,UAAsB,EAAE,QAAkB,EAAqB,EAAE,CAAC,CAAC;IACzF,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK;CAClE,CAAiC,CAAA;AAElC,MAAM,cAAc,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAA;AAEtD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,WAAW,CAAqB;IACrE,GAAG,cAAc;IACjB,SAAS,EAAE,SAAS,CAAC,cAAc,CAAC,SAAS,CAAC;IAC9C,SAAS,EAAE,SAAS,CAAC,cAAc,CAAC,SAAS,CAAC;IAC9C,QAAQ,EAAE,SAAS,CAAC,cAAc,CAAC,QAAQ,CAAC;IAC5C,GAAG,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC;IAChC,IAAI,EAAE,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC;IAClC,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC;IAC1C,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC;IAC5C,IAAI,EAAE,EAAE,GAAG,cAAc,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;IACtD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;CACjE,EAAE,UAAU,CAAC,iBAAiB,CAAC,CAAC,CAAA;AAEjC,MAAM,oBAAoB,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAA;AAE3D,mFAAmF;AACnF,MAAM,CAAC,MAAM,6BAA6B,GAAG,WAAW,CAAa;IACnE,GAAG,oBAAoB;IACvB,GAAG,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,CAAC;IACtC,EAAE,EAAE,SAAS,CAAC,oBAAoB,CAAC,EAAE,CAAC;CACvC,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAA;AAEhC,MAAM,cAAc,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAA;AAEvD,uEAAuE;AACvE,MAAM,CAAC,MAAM,uBAAuB,GAAG,WAAW,CAAe;IAC/D,GAAG,cAAc;IACjB,SAAS,EAAE,SAAS,CAAC,cAAc,CAAC,SAAS,CAAC;CAC/C,EAAE,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAA;AAElC,MAAM,gBAAgB,GAAG,YAAY,CAAC,wBAAwB,CAAC,CAAA;AAE/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,WAAW,CAAoB;IACtE,GAAG,gBAAgB;IACnB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,gBAAgB,CAAC,EAAE;IACxF,OAAO,EAAE,EAAE,GAAG,gBAAgB,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;IAC9D,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC;IAC1C,GAAG,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC;IAClC,SAAS,EAAE,SAAS,CAAC,gBAAgB,CAAC,SAAS,CAAC;IAChD,SAAS,EAAE,SAAS,CAAC,gBAAgB,CAAC,SAAS,CAAC;CACjD,EAAE,UAAU,CAAC,wBAAwB,CAAC,CAAC,CAAA"}

package/build/service.d.ts

@@ -0,0 +1,16 @@
+import type { BasicConfig, BasicContext } from '@owlmeans/context';
+import type { WithPlanningService } from '@owlmeans/planning';
+import type { PlanningHostService } from '@owlmeans/server-planning';
+import type { PostgresPlanningServiceOptions } from './types.js';
+/**
+ * The planning service over a Postgres store — what a target's own `services/planning.ts`
+ * exports as its `makeService()`. The store resolves its four resources on the service's context
+ * at the first call, so the resources are registered separately (`resources/planning/*.ts`).
+ */
+export declare const makePostgresPlanningService: (opts?: PostgresPlanningServiceOptions, alias?: string) => PlanningHostService;
+/**
+ * Register the four Postgres resources (each unless the context already has it), the planning
+ * service over them, and `context.planning()` — the one-call wiring of a hand-written backend.
+ */
+export declare const appendPostgresPlanning: <C extends BasicConfig, T extends BasicContext<C>>(ctx: T, opts?: PostgresPlanningServiceOptions, alias?: string) => T & WithPlanningService;
+//# sourceMappingURL=service.d.ts.map

package/build/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAE7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAGpE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAA;AAEhE;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,UAChC,8BAA8B,UAAc,MAAM,KACvD,mBAUF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,OAChF,CAAC,SAAQ,8BAA8B,UAAc,MAAM,KAC/D,CAAC,GAAG,mBAWN,CAAA"}

package/build/service.js

@@ -0,0 +1,34 @@
+import { DEFAULT_ALIAS, makePlanningService } from '@owlmeans/server-planning';
+import { makePlanningPostgresResources } from './resource.js';
+import { makePostgresPlanningStore, planningPostgresAliases } from './store/index.js';
+/**
+ * The planning service over a Postgres store — what a target's own `services/planning.ts`
+ * exports as its `makeService()`. The store resolves its four resources on the service's context
+ * at the first call, so the resources are registered separately (`resources/planning/*.ts`).
+ */
+export const makePostgresPlanningService = (opts = {}, alias = DEFAULT_ALIAS) => {
+    const { aliases, bus, limits, ...service } = opts;
+    let host;
+    const store = makePostgresPlanningStore({
+        aliases, bus, limits, ids: opts.ids, now: opts.now,
+        context: () => host?.ctx,
+    });
+    host = makePlanningService({ ...service, store }, alias);
+    return host;
+};
+/**
+ * Register the four Postgres resources (each unless the context already has it), the planning
+ * service over them, and `context.planning()` — the one-call wiring of a hand-written backend.
+ */
+export const appendPostgresPlanning = (ctx, opts = {}, alias = DEFAULT_ALIAS) => {
+    const context = ctx;
+    for (const resource of makePlanningPostgresResources(planningPostgresAliases(opts.aliases))) {
+        if (!context.hasResource(resource.alias)) {
+            context.registerResource(resource);
+        }
+    }
+    context.registerService(makePostgresPlanningService(opts, alias));
+    context.planning = () => context.service(alias);
+    return context;
+};
+//# sourceMappingURL=service.js.map

package/build/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAE9E,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAA;AAC7D,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAGrF;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,IAAI,GAAmC,EAAE,EAAE,KAAK,GAAW,aAAa,EACnD,EAAE;IACvB,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,GAAG,IAAI,CAAA;IACjD,IAAI,IAAqC,CAAA;IACzC,MAAM,KAAK,GAAG,yBAAyB,CAAC;QACtC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG;QAClD,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,GAAoC;KAC1D,CAAC,CAAA;IACF,IAAI,GAAG,mBAAmB,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,CAAC,CAAA;IAExD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,GAAM,EAAE,IAAI,GAAmC,EAAE,EAAE,KAAK,GAAW,aAAa,EACvD,EAAE;IAC3B,MAAM,OAAO,GAAG,GAA8B,CAAA;IAC9C,KAAK,MAAM,QAAQ,IAAI,6BAA6B,CAAC,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC5F,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QACpC,CAAC;IACH,CAAC;IACD,OAAO,CAAC,eAAe,CAAC,2BAA2B,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;IACjE,OAAO,CAAC,QAAQ,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAsB,KAAK,CAAC,CAAA;IAEpE,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}

package/build/sql.d.ts

@@ -0,0 +1,61 @@
+import type { ColumnSpec, TableSpec } from '@owlmeans/postgres-resource';
+import type { ResourceRecord } from '@owlmeans/resource';
+import type { Pool, PoolClient, QueryResultRow } from 'pg';
+/** Where a statement runs — the pool, or one open transaction. */
+export interface SqlRunner {
+    query: <R extends QueryResultRow = QueryResultRow>(text: string, params?: unknown[]) => Promise<R[]>;
+}
+/** The compiled specs of the four tables, read once the resources have initialized. */
+export interface PlanningTables {
+    card: TableSpec;
+    transition: TableSpec;
+    link: TableSpec;
+    schema: TableSpec;
+}
+/** A runner and the tables it addresses — what every statement builder takes. */
+export interface SqlContext {
+    runner: SqlRunner;
+    tables: PlanningTables;
+}
+export declare const poolRunner: (pool: Pool) => SqlRunner;
+export declare const clientRunner: (client: PoolClient, onError?: (error: unknown) => void) => SqlRunner;
+/** A property's physical column, quoted. */
+export declare const col: (spec: TableSpec, property: string) => string;
+/** A value as the driver takes it for a column: JSON text for jsonb, `null` for absent. */
+export declare const driverValue: (column: ColumnSpec, value: unknown) => unknown;
+/**
+ * A row back as a record: physical columns to properties with the package's coercions, `null`
+ * dropped (the planning records leave an absent value out), private columns removed.
+ */
+export declare const recordOf: <T extends ResourceRecord>(row: Record<string, unknown>, spec: TableSpec, hidden?: readonly string[]) => T;
+/** A resource read answered with drizzle's property-keyed rows: `null` and private keys dropped. */
+export declare const cleanRecord: <T extends object>(record: T, hidden?: readonly string[]) => T;
+export interface InsertStatement {
+    text: string;
+    params: unknown[];
+}
+/**
+ * `INSERT INTO <table> (<every column but the skipped>) VALUES (…)` for a record, with an optional
+ * tail (`ON CONFLICT …`, `RETURNING …`).
+ */
+export declare const insertOf: (spec: TableSpec, record: Record<string, unknown>, opts?: {
+    skip?: readonly string[];
+    tail?: string;
+    as?: string;
+}) => InsertStatement;
+/**
+ * A WHERE over fixed fields: a string is equality, a list is `= ANY`, `undefined` is skipped.
+ * Parameters start after `offset`.
+ */
+export declare const whereOf: (spec: TableSpec, fields: Record<string, string | readonly string[] | undefined>, offset?: number) => {
+    text: string;
+    params: unknown[];
+};
+/** The driver error's Postgres code and the constraint (index) it names, through a `cause` chain. */
+export declare const pgFault: (error: unknown) => {
+    code?: string;
+    constraint?: string;
+};
+export declare const UNIQUE_VIOLATION = "23505";
+export declare const LOCK_NOT_AVAILABLE = "55P03";
+//# sourceMappingURL=sql.d.ts.map

package/build/sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../src/sql.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,IAAI,CAAA;AAE1D,kEAAkE;AAClE,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAA;CACrG;AAED,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAA;IACf,UAAU,EAAE,SAAS,CAAA;IACrB,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,SAAS,CAAA;CAClB;AAED,iFAAiF;AACjF,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,CAAA;IACjB,MAAM,EAAE,cAAc,CAAA;CACvB;AAED,eAAO,MAAM,UAAU,SAAU,IAAI,KAAG,SAGtC,CAAA;AAEF,eAAO,MAAM,YAAY,WAAY,UAAU,YAAY,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,KAAG,SASpF,CAAA;AAEF,4CAA4C;AAC5C,eAAO,MAAM,GAAG,SAAU,SAAS,YAAY,MAAM,KAAG,MAAsD,CAAA;AAE9G,2FAA2F;AAC3F,eAAO,MAAM,WAAW,WAAY,UAAU,SAAS,OAAO,KAAG,OAMhE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,cAAc,OAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,SAAS,WAAU,SAAS,MAAM,EAAE,KACvE,CAQF,CAAA;AAED,oGAAoG;AACpG,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,UAAU,CAAC,WAAU,SAAS,MAAM,EAAE,KAAQ,CACgD,CAAA;AAE1I,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,EAAE,CAAA;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,SACb,SAAS,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SAAQ;IAAE,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,KAC/G,eAUF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,OAAO,SACZ,SAAS,UAAU,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,WAAU,MAAM,KAC9F;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAA;CAcnC,CAAA;AAED,qGAAqG;AACrG,eAAO,MAAM,OAAO,UAAW,OAAO,KAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAa5E,CAAA;AAED,eAAO,MAAM,gBAAgB,UAAU,CAAA;AACvC,eAAO,MAAM,kBAAkB,UAAU,CAAA"}

package/build/sql.js

@@ -0,0 +1,90 @@
+import { quoteIdent, rowToRecord } from '@owlmeans/postgres-resource';
+export const poolRunner = (pool) => ({
+    query: async (text, params) => (await pool.query(text, params)).rows,
+});
+export const clientRunner = (client, onError) => ({
+    query: async (text, params) => {
+        try {
+            return (await client.query(text, params)).rows;
+        }
+        catch (error) {
+            onError?.(error);
+            throw error;
+        }
+    },
+});
+/** A property's physical column, quoted. */
+export const col = (spec, property) => quoteIdent(spec.byProperty[property].column);
+/** A value as the driver takes it for a column: JSON text for jsonb, `null` for absent. */
+export const driverValue = (column, value) => {
+    if (value === undefined || value === null) {
+        return null;
+    }
+    // node-postgres would write a JS array as a Postgres array literal, which a jsonb column refuses.
+    return column.jsonb ? JSON.stringify(value) : value;
+};
+/**
+ * A row back as a record: physical columns to properties with the package's coercions, `null`
+ * dropped (the planning records leave an absent value out), private columns removed.
+ */
+export const recordOf = (row, spec, hidden = []) => {
+    const record = rowToRecord(row, spec);
+    for (const [key, value] of Object.entries(record)) {
+        if (value === null || hidden.includes(key)) {
+            delete record[key];
+        }
+    }
+    return record;
+};
+/** A resource read answered with drizzle's property-keyed rows: `null` and private keys dropped. */
+export const cleanRecord = (record, hidden = []) => Object.fromEntries(Object.entries(record).filter(([key, value]) => value !== null && value !== undefined && !hidden.includes(key)));
+/**
+ * `INSERT INTO <table> (<every column but the skipped>) VALUES (…)` for a record, with an optional
+ * tail (`ON CONFLICT …`, `RETURNING …`).
+ */
+export const insertOf = (spec, record, opts = {}) => {
+    const columns = spec.columns.filter(column => !(opts.skip ?? []).includes(column.property));
+    const params = columns.map(column => driverValue(column, record[column.property]));
+    return {
+        text: `INSERT INTO ${spec.qualified}${opts.as != null ? ` AS ${opts.as}` : ''}`
+            + ` (${columns.map(column => quoteIdent(column.column)).join(', ')})`
+            + ` VALUES (${columns.map((_, index) => `$${index + 1}`).join(', ')})${opts.tail != null ? ` ${opts.tail}` : ''}`,
+        params,
+    };
+};
+/**
+ * A WHERE over fixed fields: a string is equality, a list is `= ANY`, `undefined` is skipped.
+ * Parameters start after `offset`.
+ */
+export const whereOf = (spec, fields, offset = 0) => {
+    const clauses = [];
+    const params = [];
+    for (const [property, value] of Object.entries(fields)) {
+        if (value === undefined) {
+            continue;
+        }
+        params.push(Array.isArray(value) ? [...value] : value);
+        clauses.push(Array.isArray(value)
+            ? `${col(spec, property)} = ANY($${offset + params.length})`
+            : `${col(spec, property)} = $${offset + params.length}`);
+    }
+    return { text: clauses.length > 0 ? clauses.join(' AND ') : 'TRUE', params };
+};
+/** The driver error's Postgres code and the constraint (index) it names, through a `cause` chain. */
+export const pgFault = (error) => {
+    let current = error;
+    for (let depth = 0; depth < 5 && current != null && typeof current === 'object'; depth++) {
+        const candidate = current;
+        if (typeof candidate.code === 'string' && /^[0-9A-Z]{5}$/.test(candidate.code)) {
+            return {
+                code: candidate.code,
+                ...(typeof candidate.constraint === 'string' ? { constraint: candidate.constraint } : {}),
+            };
+        }
+        current = candidate.cause;
+    }
+    return {};
+};
+export const UNIQUE_VIOLATION = '23505';
+export const LOCK_NOT_AVAILABLE = '55P03';
+//# sourceMappingURL=sql.js.map

package/build/sql.js.map

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

package/build/store/bus.d.ts

@@ -0,0 +1,52 @@
+import type { CommitEvent, Unsubscribe } from '@owlmeans/planning';
+import type { Pool } from 'pg';
+import type { SqlRunner } from '../sql.js';
+/** A settled commit, without its record — the card is re-read where one is needed. */
+export interface CommitFrame {
+    p: string;
+    t: 'c';
+    e: Omit<CommitEvent, 'record'>;
+}
+/** A write of an organization's data-defined schemas. */
+export interface SchemaFrame {
+    p: string;
+    t: 's';
+    e: string;
+}
+export type BusFrame = CommitFrame | SchemaFrame;
+export interface PlanningBus {
+    enabled: boolean;
+    /** NOTIFY a frame inside a transaction — delivered only if it commits. A no-op when disabled. */
+    notify: (runner: SqlRunner, frame: Omit<CommitFrame, 'p'> | Omit<SchemaFrame, 'p'>) => Promise<void>;
+    onCommit: (listener: (event: CommitEvent) => void | Promise<void>) => Unsubscribe;
+    onSchema: (listener: (entityId: string) => void) => Unsubscribe;
+    /** Open the LISTEN connection if it is not open (lazily, on the first subscription or wait). */
+    ensure: () => void;
+    connected: () => boolean;
+    close: () => Promise<void>;
+}
+export interface PlanningBusOptions {
+    enabled: boolean;
+    processId: string;
+    /** The qualified transition table — what the channel name is derived from. */
+    table: () => Promise<string>;
+    /** The pool whose configuration the dedicated connection copies. */
+    pool: () => Promise<Pool>;
+}
+/**
+ * The channel of one transition table: `planning_` and a short hash of its qualified name, so two
+ * schemas in one database never hear each other.
+ */
+export declare const planningChannel: (qualified: string) => string;
+/**
+ * The cross-process commit bus over LISTEN/NOTIFY.
+ *
+ * NOTIFY runs inside the transaction that settled the commit, so a frame is heard only if that
+ * commit landed. LISTEN holds ONE dedicated connection — a `pg.Client` built from the pool's own
+ * configuration, never a pooled one, so it takes no pool slot — opened on the first subscription
+ * or wait. A dropped connection reconnects with backoff (1 s doubling to 30 s); meanwhile the commit
+ * hub's poll ladder still answers every waiter. A process ignores its own frames (`p`): it delivered
+ * them itself, after its commit.
+ */
+export declare const makePlanningBus: (opts: PlanningBusOptions) => PlanningBus;
+//# sourceMappingURL=bus.d.ts.map

package/build/store/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../src/store/bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAGlE,OAAO,KAAK,EAA8B,IAAI,EAAE,MAAM,IAAI,CAAA;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE1C,sFAAsF;AACtF,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,GAAG,CAAA;IACN,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;CAC/B;AAED,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,GAAG,CAAA;IACN,CAAC,EAAE,MAAM,CAAA;CACV;AAED,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAA;AAEhD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,iGAAiG;IACjG,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpG,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,WAAW,CAAA;IACjF,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,KAAK,WAAW,CAAA;IAC/D,gGAAgG;IAChG,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,SAAS,EAAE,MAAM,OAAO,CAAA;IACxB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,8EAA8E;IAC9E,KAAK,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAC5B,oEAAoE;IACpE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,cAAe,MAAM,KAAG,MAGnD,CAAA;AAeD;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,SAAU,kBAAkB,KAAG,WA4I1D,CAAA"}