@signstack/cli 0.1.1

package/dist/libs/signstack/base/src/lib/models/resource-edge.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceKind = void 0;
+exports.toResourceCascadeKey = toResourceCascadeKey;
+exports.parseResourceCascadeKey = parseResourceCascadeKey;
+exports.toResourceId = toResourceId;
+exports.parseResourceId = parseResourceId;
+exports.getTemplateDeps = getTemplateDeps;
+exports.getAssetDeps = getAssetDeps;
+exports.getFunctionDeps = getFunctionDeps;
+exports.getBlueprintDeps = getBlueprintDeps;
+exports.collectTransitiveDeps = collectTransitiveDeps;
+var ResourceKind;
+(function (ResourceKind) {
+    ResourceKind["Blueprint"] = "blueprint";
+    ResourceKind["Template"] = "template";
+    ResourceKind["Schema"] = "schema";
+    ResourceKind["Asset"] = "asset";
+    ResourceKind["JsonataFunction"] = "jsonata_function";
+})(ResourceKind || (exports.ResourceKind = ResourceKind = {}));
+function toResourceCascadeKey(kind, key) {
+    return `${kind}:${key}`;
+}
+function parseResourceCascadeKey(resourceCascadeKey) {
+    const colonIdx = resourceCascadeKey.indexOf(':');
+    if (colonIdx === -1) {
+        return { kind: '', key: resourceCascadeKey };
+    }
+    return {
+        kind: resourceCascadeKey.substring(0, colonIdx),
+        key: resourceCascadeKey.substring(colonIdx + 1),
+    };
+}
+function toResourceId(kind, key, version) {
+    return `${toResourceCascadeKey(kind, key)}@${version}`;
+}
+function parseResourceId(resourceId) {
+    const atIdx = resourceId.lastIndexOf('@');
+    const cascadeKey = resourceId.substring(0, atIdx);
+    const parsedCascade = parseResourceCascadeKey(cascadeKey);
+    return {
+        kind: parsedCascade.kind,
+        key: parsedCascade.key,
+        version: resourceId.substring(atIdx + 1),
+    };
+}
+/** Template spec → direct deps: content asset, functions, input schemas. */
+function getTemplateDeps(spec) {
+    const deps = [];
+    if (spec.contentKey && spec.contentVersion) {
+        deps.push({
+            kind: ResourceKind.Asset,
+            key: spec.contentKey,
+            version: spec.contentVersion,
+        });
+    }
+    for (const dep of spec.functions ?? []) {
+        deps.push({
+            kind: ResourceKind.JsonataFunction,
+            key: dep.functionKey,
+            version: dep.functionVersion,
+        });
+    }
+    for (const input of spec.inputs ?? []) {
+        if (input.schemaKey) {
+            deps.push({
+                kind: ResourceKind.Schema,
+                key: input.schemaKey,
+                version: input.schemaVersion,
+            });
+        }
+    }
+    for (const role of spec.roles ?? []) {
+        if (role.output) {
+            deps.push({ kind: ResourceKind.Schema, key: role.output.schemaKey, version: role.output.schemaVersion });
+        }
+    }
+    return deps;
+}
+/** Asset spec → direct deps: sub-assets (partials/images/styles), viewModelSchema. */
+function getAssetDeps(spec) {
+    const deps = [];
+    const config = spec.htmlConfig;
+    if (!config)
+        return deps;
+    for (const ref of [
+        ...(config.partials ?? []),
+        ...(config.styles ?? []),
+        ...(config.images ?? []),
+    ]) {
+        deps.push({ kind: ResourceKind.Asset, key: ref.key, version: ref.version });
+    }
+    if (config.data?.schemaKey && config.data?.schemaVersion) {
+        deps.push({
+            kind: ResourceKind.Schema,
+            key: config.data.schemaKey,
+            version: config.data.schemaVersion,
+        });
+    }
+    return deps;
+}
+/** Function spec → direct deps: param schemas, returnType schema. */
+function getFunctionDeps(spec) {
+    const deps = [];
+    for (const param of spec.params ?? []) {
+        if (param.schemaKey && param.schemaVersion) {
+            deps.push({
+                kind: ResourceKind.Schema,
+                key: param.schemaKey,
+                version: param.schemaVersion,
+            });
+        }
+    }
+    if (spec.returnType?.schemaKey && spec.returnType?.schemaVersion) {
+        deps.push({
+            kind: ResourceKind.Schema,
+            key: spec.returnType.schemaKey,
+            version: spec.returnType.schemaVersion,
+        });
+    }
+    return deps;
+}
+/** Blueprint spec → direct deps: functions, input schemas, envelope templates. */
+function getBlueprintDeps(spec) {
+    const deps = [];
+    for (const f of spec.functions ?? []) {
+        deps.push({
+            kind: ResourceKind.JsonataFunction,
+            key: f.functionKey,
+            version: f.functionVersion,
+        });
+    }
+    for (const input of spec.inputs ?? []) {
+        if (input.schemaKey) {
+            deps.push({
+                kind: ResourceKind.Schema,
+                key: input.schemaKey,
+                version: input.schemaVersion,
+            });
+        }
+    }
+    for (const envelope of spec.envelopes ?? []) {
+        for (const doc of envelope.documents ?? []) {
+            if (doc.templateKey && doc.templateVersion) {
+                deps.push({
+                    kind: ResourceKind.Template,
+                    key: doc.templateKey,
+                    version: doc.templateVersion,
+                });
+            }
+        }
+    }
+    return deps;
+}
+/**
+ * Collect all transitive deps starting from a template spec.
+ * Walks: template → (assets, functions, schemas) → (sub-assets, function schemas) → ...
+ * Uses lookup functions to resolve specs for intermediate resources.
+ * Returns deduplicated flat array of all deps (direct + transitive).
+ */
+function collectTransitiveDeps(templateSpec, lookups) {
+    const visited = new Set();
+    const result = [];
+    const toId = (dep) => toResourceId(dep.kind, dep.key, dep.version);
+    const add = (dep) => {
+        const id = toId(dep);
+        if (visited.has(id))
+            return;
+        visited.add(id);
+        result.push(dep);
+    };
+    const walkAsset = (key, version) => {
+        const spec = lookups.getAssetSpec?.(key, version);
+        if (!spec)
+            return;
+        for (const dep of getAssetDeps(spec)) {
+            add(dep);
+            if (dep.kind === ResourceKind.Asset) {
+                walkAsset(dep.key, dep.version);
+            }
+        }
+    };
+    const walkFunction = (key, version) => {
+        const spec = lookups.getFunctionSpec?.(key, version);
+        if (!spec)
+            return;
+        for (const dep of getFunctionDeps(spec)) {
+            add(dep);
+        }
+    };
+    for (const dep of getTemplateDeps(templateSpec)) {
+        add(dep);
+        if (dep.kind === ResourceKind.Asset) {
+            walkAsset(dep.key, dep.version);
+        }
+        else if (dep.kind === ResourceKind.JsonataFunction) {
+            walkFunction(dep.key, dep.version);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=resource-edge.js.map

package/dist/libs/signstack/base/src/lib/models/resource-edge.js.map

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

package/dist/libs/signstack/base/src/lib/models/scenario.d.ts

@@ -0,0 +1,138 @@
+import { PaginationDto, ResourceIdentity } from './base';
+export interface ScenarioEntity {
+    key: string;
+    data: Record<string, any>;
+}
+export interface EntitySchemaIdentifier {
+    key: string;
+    schemaKey: string;
+    /** Optional inline schema definition — used when the schema is not yet saved to the database */
+    schemaDefinition?: Record<string, any>;
+}
+export interface ListScenariosReq {
+    search?: string;
+    limit?: number;
+    offset?: number;
+    labels?: Record<string, string>;
+}
+/**
+ * Identity fields for a scenario. Same shape as `ResourceIdentity` —
+ * scenarios share the universal identity surface (key, name, description,
+ * labels) but don't carry `version` since they have no draft/published
+ * lifecycle (see Resource Lifecycle docs for the carve-out rationale).
+ */
+export type ScenarioMetadata = ResourceIdentity;
+export interface ScenarioSpec {
+    entities: ScenarioEntity[];
+}
+/**
+ * Full scenario — returned by `GET /scenarios/{key}`, `POST /scenarios`,
+ * and `PUT /scenarios/{key}`. The optimistic-locking handle is in the
+ * `ETag` HTTP response header (RFC 7232) — pass it back as `If-Match` on
+ * subsequent `PUT` / `DELETE`.
+ */
+export interface ScenarioResp {
+    metadata: ScenarioMetadata;
+    spec: ScenarioSpec;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Trimmed scenario summary returned by `GET /scenarios`. `spec` carries
+ * just the entity keys; the full per-entity `data` is omitted. Fetch
+ * `GET /scenarios/{key}` for the full `ScenarioResp` (and its `ETag`
+ * header) before any mutation.
+ */
+export interface ScenarioListItem {
+    metadata: ScenarioMetadata;
+    spec: {
+        /** Keys of every entity in this scenario. Fetch the scenario by key for the actual `data` payloads. */
+        entityKeys: string[];
+    };
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface ListScenariosResp {
+    data: ScenarioListItem[];
+    pagination: PaginationDto;
+}
+export interface CreateScenarioReq {
+    metadata: ScenarioMetadata;
+    spec: ScenarioSpec;
+}
+/**
+ * Update body for `PUT /scenarios/{key}`. Send the full `metadata` + `spec`
+ * envelope. The path `key` is the source of truth — `metadata.key` in the
+ * body is required for shape parity with create / other resources but
+ * ignored on the server. Matches the wire pattern used by every other
+ * resource update.
+ */
+export interface UpdateScenarioReq {
+    metadata: ScenarioMetadata;
+    spec: ScenarioSpec;
+}
+export interface AddMissingDataToScenarioReq {
+    entities?: EntitySchemaIdentifier[];
+}
+export interface AddMissingDataToScenarioResp {
+    key: string;
+}
+export declare enum ScenarioUseMode {
+    Existing = "existing",
+    Auto = "auto"
+}
+export declare enum ResourceAssociationType {
+    Template = "template",
+    Blueprint = "blueprint"
+}
+export interface AutoGenerateScenarioReq {
+    entities: {
+        key: string;
+        schemaKey: string;
+        /** Inline schema definition — used when the schema may not yet exist in the database */
+        schemaDefinition?: Record<string, any>;
+    }[];
+    persist?: boolean;
+}
+export interface AutoGenerateScenarioResp {
+    key?: string;
+    name?: string;
+    description?: string;
+    entities?: ScenarioEntity[];
+}
+export interface ResourceScenarioLink {
+    resourceKey: string;
+    resourceVersion: string;
+    resourceType: ResourceAssociationType;
+    scenarioKey: string;
+}
+export interface LinkScenarioReq extends ResourceScenarioLink {
+}
+export interface UnlinkScenarioReq extends ResourceScenarioLink {
+}
+export interface ListLinkedScenariosReq {
+    resourceKey: string;
+    resourceVersion: string;
+    resourceType: ResourceAssociationType;
+}
+export interface ListLinkedScenariosResp {
+    /**
+     * Full scenarios — Studio's preview surface uses the entity data inline.
+     * Each item carries `eTag` in the body because list responses can't
+     * multiplex `ETag` headers per item; consumers can mutate the scenario
+     * directly from this list shape (one-click PATCH from a tree node).
+     */
+    data: (ScenarioResp & {
+        eTag: string;
+    })[];
+}
+export interface ListLinkedResourcesReq {
+    scenarioKey: string;
+}
+export interface ListLinkedResourcesResp {
+    data: {
+        resourceKey: string;
+        resourceVersion: string;
+        resourceType: ResourceAssociationType;
+    }[];
+}

package/dist/libs/signstack/base/src/lib/models/scenario.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceAssociationType = exports.ScenarioUseMode = void 0;
+var ScenarioUseMode;
+(function (ScenarioUseMode) {
+    ScenarioUseMode["Existing"] = "existing";
+    ScenarioUseMode["Auto"] = "auto";
+})(ScenarioUseMode || (exports.ScenarioUseMode = ScenarioUseMode = {}));
+var ResourceAssociationType;
+(function (ResourceAssociationType) {
+    ResourceAssociationType["Template"] = "template";
+    ResourceAssociationType["Blueprint"] = "blueprint";
+})(ResourceAssociationType || (exports.ResourceAssociationType = ResourceAssociationType = {}));
+//# sourceMappingURL=scenario.js.map

package/dist/libs/signstack/base/src/lib/models/scenario.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario.js","sourceRoot":"","sources":["../../../../../../../../../libs/signstack/base/src/lib/models/scenario.ts"],"names":[],"mappings":";;;AA4FA,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,wCAAqB,CAAA;IACrB,gCAAa,CAAA;AACf,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B;AAED,IAAY,uBAGX;AAHD,WAAY,uBAAuB;IACjC,gDAAqB,CAAA;IACrB,kDAAuB,CAAA;AACzB,CAAC,EAHW,uBAAuB,uCAAvB,uBAAuB,QAGlC"}

package/dist/libs/signstack/base/src/lib/models/schema.d.ts

@@ -0,0 +1,131 @@
+import { JsonSchemaDraft } from '@common/base';
+import { ActorRef, ListResp, ResourceListItemBase, ResourceMetadata, VersionType } from './base';
+export { JsonSchemaDraft };
+export interface SchemaResource {
+    metadata: ResourceMetadata;
+    spec: SchemaSpec;
+}
+export interface SchemaSpec {
+    jsonSchemaDraft: JsonSchemaDraft;
+    schemaDefinition: Record<string, any>;
+}
+export declare const JSON_SCHEMA_DRAFTS: {
+    value: string;
+    url: string;
+    label: string;
+    description: string;
+}[];
+export declare enum SchemaEventType {
+    StatusChanged = "status_changed",
+    DescriptionUpdated = "description_updated",
+    DefinitionUpdated = "definition_updated"
+}
+export interface ListSchemaReq {
+    offset?: number;
+    limit?: number;
+    skipDraft?: boolean;
+    search?: string;
+    labels?: Record<string, string>;
+}
+export type ListSchemasResp = ListResp<SchemaListItem>;
+export type ListSchemaVersionsResp = ListResp<SchemaListItem>;
+export interface SchemaListItem extends ResourceListItemBase {
+}
+/**
+ * Full schema — returned by `GET /schemas/{key}`, `POST /schemas`,
+ * `PUT .../versions/draft`, and `POST .../versions/draft/publish`. The
+ * optimistic-locking handle is returned in the HTTP `ETag` response header
+ * (RFC 7232) — pass it back as `If-Match` on the next `PUT` / `DELETE`.
+ */
+export interface SchemaResp extends SchemaResource {
+    createdAt: Date;
+    updatedAt: Date;
+    createdBy: ActorRef;
+    publishedAt?: Date;
+    publishedBy?: ActorRef;
+    contentHash?: string;
+}
+export interface BatchGetSchemasReq {
+    identifiers: {
+        key: string;
+        version?: string;
+    }[];
+}
+export interface BatchGetSchemaItem extends SchemaResp {
+    _eTag?: string;
+}
+export interface BatchGetSchemasResp {
+    data: BatchGetSchemaItem[];
+}
+export interface CreateSchemaReq {
+    apiVersion?: string;
+    metadata: ResourceMetadata;
+    spec: SchemaSpec;
+}
+export interface UpdateSchemaReq {
+    metadata: ResourceMetadata;
+    spec: SchemaSpec;
+}
+export interface PublishSchemaReq {
+    versionType?: VersionType;
+    version?: string;
+}
+export interface Entity {
+    key: string;
+    schemaKey: string;
+    version: string;
+    data: any;
+}
+export interface AddEntitiesResp {
+    entities: {
+        entityId: string;
+        entityType: string;
+        clientRefId?: string;
+    }[];
+}
+export interface GenerateSchemaExamplesReq {
+    schemaKeys: string[];
+}
+export interface GenerateSchemaExamplesResp {
+    schemaKey: string;
+    version: string;
+    schemaDefinition: Record<string, any>;
+    exampleData: Record<string, any>;
+}
+export interface GenerateSchemaFromSampleReq {
+    sampleJson: Record<string, any>;
+    jsonSchemaDraft: JsonSchemaDraft;
+}
+export interface GenerateSchemaFromSampleResp {
+    schemaDefinition: Record<string, any>;
+}
+export interface GenerateSchemaPlaceholdersReq {
+    schemaKeys: string[];
+}
+export interface GenerateSchemaPlaceholdersResp {
+    data: {
+        schemaKey: string;
+        placeholderData: Record<string, any>;
+    }[];
+}
+export interface GenerateScenariosInlineReq {
+    schemas: Array<{
+        key: string;
+        schemaDefinition: Record<string, any>;
+    }>;
+    context?: string;
+}
+export interface GenerateScenariosInlineScenario {
+    name: string;
+    entities: Array<{
+        schemaKey: string;
+        exampleData: Record<string, any>;
+    }>;
+}
+export interface GenerateScenariosInlineResp {
+    scenarios: GenerateScenariosInlineScenario[];
+}
+export interface SchemaFormData {
+    jsonSchemaDraft: JsonSchemaDraft;
+    schemaDefinition: string;
+}

package/dist/libs/signstack/base/src/lib/models/schema.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaEventType = exports.JSON_SCHEMA_DRAFTS = exports.JsonSchemaDraft = void 0;
+const base_1 = require("@common/base");
+Object.defineProperty(exports, "JsonSchemaDraft", { enumerable: true, get: function () { return base_1.JsonSchemaDraft; } });
+exports.JSON_SCHEMA_DRAFTS = [
+    {
+        value: '2020-12',
+        url: 'https://json-schema.org/draft/2020-12/schema',
+        label: 'Draft 2020-12 (Latest)',
+        description: 'Latest specification with enhanced features',
+    },
+    {
+        value: '2019-09',
+        url: 'https://json-schema.org/draft/2019-09/schema',
+        label: 'Draft 2019-09',
+        description: 'Multi-specification approach with vocabulary system',
+    },
+    {
+        value: 'draft-07',
+        url: 'https://json-schema.org/draft-07/schema#',
+        label: 'Draft 7',
+        description: 'Widely supported with if/then/else validation',
+    },
+    {
+        value: 'draft-06',
+        url: 'https://json-schema.org/draft-06/schema#',
+        label: 'Draft 6',
+        description: 'Added const and contains keywords',
+    },
+    {
+        value: 'draft-04',
+        url: 'https://json-schema.org/draft-04/schema#',
+        label: 'Draft 4',
+        description: 'Legacy support - widely compatible',
+    },
+];
+var SchemaEventType;
+(function (SchemaEventType) {
+    SchemaEventType["StatusChanged"] = "status_changed";
+    SchemaEventType["DescriptionUpdated"] = "description_updated";
+    SchemaEventType["DefinitionUpdated"] = "definition_updated";
+})(SchemaEventType || (exports.SchemaEventType = SchemaEventType = {}));
+//# sourceMappingURL=schema.js.map

package/dist/libs/signstack/base/src/lib/models/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../../../../../../libs/signstack/base/src/lib/models/schema.ts"],"names":[],"mappings":";;;AAAA,uCAA+C;AAStC,gGATA,sBAAe,OASA;AAYX,QAAA,kBAAkB,GAAG;IAChC;QACE,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,8CAA8C;QACnD,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,6CAA6C;KAC3D;IACD;QACE,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,8CAA8C;QACnD,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,qDAAqD;KACnE;IACD;QACE,KAAK,EAAE,UAAU;QACjB,GAAG,EAAE,0CAA0C;QAC/C,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,+CAA+C;KAC7D;IACD;QACE,KAAK,EAAE,UAAU;QACjB,GAAG,EAAE,0CAA0C;QAC/C,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,mCAAmC;KACjD;IACD;QACE,KAAK,EAAE,UAAU;QACjB,GAAG,EAAE,0CAA0C;QAC/C,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,oCAAoC;KAClD;CACF,CAAC;AAEF,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,mDAAgC,CAAA;IAChC,6DAA0C,CAAA;IAC1C,2DAAwC,CAAA;AAC1C,CAAC,EAJW,eAAe,+BAAf,eAAe,QAI1B"}