@mdbase-dev/sdk 0.0.0-stage → 0.1.0-beta.153

package/node_modules/@mdbase-dev/connect-protocol/dist/type-packs.d.ts

@@ -0,0 +1,154 @@
+export interface ContractRequirement {
+    id: string;
+    /** Exact semantic version of the collection-local mdbase data contract. */
+    version: string;
+    /** Exact digest of the resolved portable contract identity. */
+    digest: string;
+}
+/** Exact identity of the standard record-created runtime event contract. */
+export declare const MDBASE_RECORD_CREATED_CONTRACT: {
+    readonly id: "mdbase.record.created";
+    readonly version: "1.0.0";
+    readonly digest: "sha256:7f3bed6baa356ee9389e977ae7b77a102e2bee871a7c1d9f2026fc21cacdbfc9";
+};
+/** Exact identity of the standard record-modified runtime event contract. */
+export declare const MDBASE_RECORD_MODIFIED_CONTRACT: {
+    readonly id: "mdbase.record.modified";
+    readonly version: "1.0.0";
+    readonly digest: "sha256:064187148a95701a1f5c749643d306d3c6708470b6b7ab0bf0c698d38dbcabe3";
+};
+/** Exact identity of the standard record-deleted runtime event contract. */
+export declare const MDBASE_RECORD_DELETED_CONTRACT: {
+    readonly id: "mdbase.record.deleted";
+    readonly version: "1.0.0";
+    readonly digest: "sha256:84e5fb0f9d3bfdcd53f76cdc5035f94c7693fdea39a8ead190b10b422dd2ee09";
+};
+/** Exact identity of the standard record-renamed runtime event contract. */
+export declare const MDBASE_RECORD_RENAMED_CONTRACT: {
+    readonly id: "mdbase.record.renamed";
+    readonly version: "1.0.0";
+    readonly digest: "sha256:c825ef8d7db775b784d7af27e6acdf6f2799d2c6440d486f5bfa78afcca71471";
+};
+/** Exact identity of the standard timer-fired runtime event contract. */
+export declare const MDBASE_TIMER_FIRED_CONTRACT: {
+    readonly id: "mdbase.runtime.timer.fired";
+    readonly version: "1.0.0";
+    readonly digest: "sha256:41105be7a7abf33b31ced47e1e1965242236e40ccaea286b959b0a8c591f5642";
+};
+/** Exact bytes of a starter the publisher previously shipped for a seed type. */
+type TypePackUpgradeBaseline = {
+    digest: string;
+    document: string;
+    /** The `version` the baseline document declares, for presentation only. */
+    version?: number;
+};
+export interface TypePackManifestResource {
+    /**
+     * Previously shipped starters this seed type may be upgraded from; only valid
+     * for seed type resources. A single baseline is equivalent to a one-item list.
+     */
+    upgrade_from?: TypePackUpgradeBaseline | TypePackUpgradeBaseline[];
+    kind: "contract" | "type" | "schema";
+    mode: "managed" | "seed";
+    source: string;
+    target: string;
+    digest: string;
+}
+export interface TypePackManifest {
+    kind: "mdbase.type-pack";
+    id: string;
+    version: string;
+    name?: string;
+    description?: string;
+    resources: TypePackManifestResource[];
+    [extension: `x-${string}`]: unknown;
+}
+export interface TypePackSourceResource {
+    source: string;
+    document: string;
+}
+export interface TypePackProvision {
+    /** Canonical type-pack manifest shown during approval and verified on install. */
+    manifest: TypePackManifest;
+    /** Exact UTF-8 resource bytes, keyed by each manifest source path. */
+    resources: TypePackSourceResource[];
+    /** Data contracts expected after the complete pack is installed. */
+    provides: ContractRequirement[];
+}
+export interface TypePackResourceDiff {
+    source: string;
+    target: string;
+    kind: "contract" | "type" | "schema";
+    mode: "managed" | "seed";
+    action: "create" | "update" | "delete" | "adopt" | "unchanged" | "preserve" | "conflict";
+    digest: string;
+    current_digest?: string;
+    installed_digest?: string;
+    adopted_from_digest?: string;
+    /** The declared baseline an engine upgraded this seed from (seed `update` only). */
+    upgrade_baseline?: {
+        digest: string;
+        version?: number;
+    };
+    reason?: string;
+}
+export interface TypePackReceipt {
+    id: string;
+    version: string;
+    digest: string;
+    installed_by: string;
+    resources: Array<Omit<TypePackResourceDiff, "action" | "current_digest" | "installed_digest" | "upgrade_baseline" | "reason"> & {
+        /** Seed only: the publisher document the target descends from, when known. */
+        origin_digest?: string;
+    }>;
+}
+export interface TypePackAssessment {
+    status: "current" | "install" | "upgrade" | "downgrade" | "reconfigure" | "conflict";
+    applicable: boolean;
+    assessment_digest: string;
+    current?: TypePackReceipt;
+    desired: TypePackReceipt;
+    resources: TypePackResourceDiff[];
+    lock: {
+        target: "mdbase.lock.yaml";
+        action: "create" | "update" | "unchanged";
+        digest: string;
+    };
+    contract_setups: {
+        choices: ContractSetupChoice[];
+        resources: TypePackResourceDiff[];
+    };
+}
+export interface TypePackApplyResult extends TypePackAssessment {
+    receipt: TypePackReceipt;
+    cleanup_deferred: boolean;
+}
+export interface AssessTypePackInput {
+    provision: TypePackProvision;
+    installed_by: string;
+    /** Explicit digest-pinned consent to claim differing unmanaged managed targets. */
+    adopt_resources?: Record<string, string>;
+    /** Seed resources deliberately omitted because the user selected an existing implementation. */
+    preserve_seed_targets?: string[];
+    /** Resolve canonical manifest targets to collection-specific paths. */
+    target_overrides?: Record<string, string>;
+    /** Reviewed edits to user-owned types, committed atomically with the pack. */
+    contract_setups?: ContractSetupChoice[];
+}
+export interface ApplyTypePackInput extends AssessTypePackInput {
+    expected_assessment_digest: string;
+    allow_downgrade?: boolean;
+}
+export type ContractSetupChoice = {
+    contract: ContractRequirement;
+    mode: "starter";
+} | {
+    contract: ContractRequirement;
+    mode: "existing";
+    type_name: string;
+    /** Exact type source revision shown during approval. */
+    type_revision: string;
+    fields: Record<string, string>;
+    binding?: Record<string, unknown>;
+};
+export {};

package/node_modules/@mdbase-dev/connect-protocol/dist/type-packs.js

@@ -0,0 +1,30 @@
+/** Exact identity of the standard record-created runtime event contract. */
+export const MDBASE_RECORD_CREATED_CONTRACT = {
+    id: "mdbase.record.created",
+    version: "1.0.0",
+    digest: "sha256:7f3bed6baa356ee9389e977ae7b77a102e2bee871a7c1d9f2026fc21cacdbfc9",
+};
+/** Exact identity of the standard record-modified runtime event contract. */
+export const MDBASE_RECORD_MODIFIED_CONTRACT = {
+    id: "mdbase.record.modified",
+    version: "1.0.0",
+    digest: "sha256:064187148a95701a1f5c749643d306d3c6708470b6b7ab0bf0c698d38dbcabe3",
+};
+/** Exact identity of the standard record-deleted runtime event contract. */
+export const MDBASE_RECORD_DELETED_CONTRACT = {
+    id: "mdbase.record.deleted",
+    version: "1.0.0",
+    digest: "sha256:84e5fb0f9d3bfdcd53f76cdc5035f94c7693fdea39a8ead190b10b422dd2ee09",
+};
+/** Exact identity of the standard record-renamed runtime event contract. */
+export const MDBASE_RECORD_RENAMED_CONTRACT = {
+    id: "mdbase.record.renamed",
+    version: "1.0.0",
+    digest: "sha256:c825ef8d7db775b784d7af27e6acdf6f2799d2c6440d486f5bfa78afcca71471",
+};
+/** Exact identity of the standard timer-fired runtime event contract. */
+export const MDBASE_TIMER_FIRED_CONTRACT = {
+    id: "mdbase.runtime.timer.fired",
+    version: "1.0.0",
+    digest: "sha256:41105be7a7abf33b31ced47e1e1965242236e40ccaea286b959b0a8c591f5642",
+};

package/node_modules/@mdbase-dev/connect-protocol/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@mdbase-dev/connect-protocol",
+  "version": "0.1.0-beta.145",
+  "private": false,
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mdbase-dev/mdbase-connect.git",
+    "directory": "packages/protocol"
+  },
+  "homepage": "https://mdbase.dev",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./manifest": {
+      "types": "./dist/manifest.d.ts",
+      "import": "./dist/manifest.js"
+    },
+    "./next-authorization": {
+      "types": "./dist/next-authorization.d.ts",
+      "import": "./dist/next-authorization.js"
+    },
+    "./schemas/*": "./schemas/*"
+  },
+  "files": [
+    "dist",
+    "schemas"
+  ],
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
+    "test": "node --test test/*.test.mjs && node ../../scripts/generate-manifest-validators.mjs --check && node ../../scripts/generate-change-events.mjs --check && node ../../scripts/generate-connect-problems.mjs --check && node ../../scripts/generate-operation-catalog.mjs --check && node ../../scripts/generate-application-capabilities.mjs --check",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@noble/hashes": "2.4.0",
+    "yaml": "^2.9.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "ajv": "^8.20.0",
+    "ajv-formats": "^3.0.1",
+    "esbuild": "^0.28.1",
+    "typescript": "^7.0.2"
+  }
+}

package/node_modules/@mdbase-dev/connect-protocol/schemas/application-capability-catalog.v1.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "catalog_version": 1,
+  "capabilities": [
+    { "id": "collection.inspect", "operations": ["describe"] },
+    { "id": "records.watch", "operations": ["changes"] },
+    { "id": "records.read", "operations": ["read"] },
+    { "id": "records.query", "operations": ["query"] },
+    { "id": "records.validate", "operations": ["validate"] },
+    { "id": "records.create", "operations": ["create"] },
+    { "id": "records.update", "operations": ["update"] },
+    { "id": "records.delete", "operations": ["delete"] },
+    { "id": "records.rename", "operations": ["rename"] },
+    { "id": "views.list", "operations": ["list_views"] },
+    { "id": "views.execute", "operations": ["execute_view"] },
+    { "id": "views.source.read", "operations": ["read_view_source"] },
+    { "id": "views.source.create", "operations": ["create_view_source"] },
+    { "id": "views.source.update", "operations": ["update_view_source"] },
+    { "id": "views.source.delete", "operations": ["delete_view_source"] },
+    { "id": "definitions.contracts.current", "operations": [] },
+    { "id": "definitions.read", "operations": ["read_type"] },
+    { "id": "definitions.create", "operations": ["create_type"] },
+    { "id": "definitions.update", "operations": ["update_type"] },
+    { "id": "definitions.type-pack.inspect", "operations": ["assess_type_pack"] },
+    { "id": "definitions.type-pack.apply", "operations": ["assess_type_pack", "apply_type_pack"] },
+    { "id": "collection.setup.apply", "operations": ["assess_collection_setup", "apply_collection_setup"] },
+    { "id": "timers.list", "operations": ["list_timers"] },
+    { "id": "timers.put", "operations": ["put_timer"] },
+    { "id": "timers.cancel", "operations": ["cancel_timer"] },
+    { "id": "timers.reconcile", "operations": ["reconcile_timers"] },
+    { "id": "sync.offline-replica", "operations": ["sync"] },
+    { "id": "notifications.background-delivery", "operations": [] },
+    { "id": "files.list", "operations": [] },
+    { "id": "files.read", "operations": [] },
+    { "id": "files.add", "operations": [] },
+    { "id": "files.replace", "operations": [] },
+    { "id": "files.move", "operations": [] },
+    { "id": "files.delete", "operations": [] }
+  ]
+}

package/node_modules/@mdbase-dev/connect-protocol/schemas/application-capability-catalog.v2.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "catalog_version": 2,
+  "capabilities": [
+    {
+      "id": "collection.read",
+      "operations": [
+        "describe",
+        "changes",
+        "read",
+        "query",
+        "list_views",
+        "execute_view",
+        "read_view_source",
+        "validate",
+        "read_type"
+      ]
+    },
+    {
+      "id": "records.create",
+      "operations": ["create"]
+    },
+    {
+      "id": "records.edit",
+      "operations": ["update", "rename"]
+    },
+    {
+      "id": "records.delete",
+      "operations": ["delete"]
+    },
+    {
+      "id": "views.manage",
+      "operations": [
+        "create_view_source",
+        "update_view_source",
+        "delete_view_source"
+      ]
+    },
+    {
+      "id": "definitions.manage",
+      "operations": [
+        "create_type",
+        "update_type",
+        "assess_type_pack",
+        "apply_type_pack"
+      ]
+    },
+    {
+      "id": "background.schedule",
+      "operations": [
+        "list_timers",
+        "put_timer",
+        "cancel_timer",
+        "reconcile_timers"
+      ]
+    },
+    {
+      "id": "offline.replica",
+      "operations": ["sync"]
+    }
+  ],
+  "structured_authorities": {
+    "application_setup": [
+      "assess_collection_setup",
+      "apply_collection_setup"
+    ]
+  }
+}

package/node_modules/@mdbase-dev/connect-protocol/schemas/catalog.json

@@ -0,0 +1,17 @@
+{
+  "manifest_version": 1,
+  "schemas": {
+    "app_manifest": "./mdbase-app.schema.json",
+    "data_contract": "./data-contract.schema.json",
+    "event_action_interop": "./interop/v0.1/profile.schema.json",
+    "connect_protocol": "./connect-protocol.v1.schema.json",
+    "connect_problem": "./connect-problem.v1.schema.json",
+    "connect_problem_catalog": "./connect-problems.v1.catalog.json",
+    "mdbase_query_v0_3": "./mdbase-query.v0.3.schema.json",
+    "encrypted_relay": "./encrypted-relay.v3.schema.json",
+    "encrypted_relay_legacy_v2": "./encrypted-relay.v2.schema.json",
+    "files": "./files.v1.schema.json",
+    "notification_webhook": "./notification-webhook.v1.schema.json",
+    "sync": "./sync.v1.schema.json"
+  }
+}

package/node_modules/@mdbase-dev/connect-protocol/schemas/change-events.v1.json

@@ -0,0 +1,48 @@
+{
+  "version": 1,
+  "events": {
+    "mdbase.record.created": "record.created",
+    "mdbase.record.modified": "record.updated",
+    "mdbase.record.deleted": "record.deleted",
+    "mdbase.record.renamed": "record.renamed",
+    "mdbase.type.changed": "schema.changed",
+    "mdbase.config.changed": "config.changed",
+    "mdbase.contract.changed": "contract.changed",
+    "mdbase.view.changed": "view.changed",
+    "mdbase.view_source.changed": "view.changed",
+    "mdbase.resource.changed": "file.changed",
+    "mdbase.file.put": "file.put",
+    "mdbase.file.remove": "file.removed",
+    "file_put": "file.put",
+    "file_remove": "file.removed",
+    "mdbase.collection.invalidated": "gap"
+  },
+  "payloads": {
+    "RecordChangePayload": {
+      "path": "string",
+      "from": "string",
+      "to": "string",
+      "previous_revision": "string",
+      "revision": "string",
+      "previous_types": "strings",
+      "types": "strings",
+      "changed_fields": "strings",
+      "body_changed": "boolean",
+      "before": "object",
+      "after": "object"
+    },
+    "ResourceChangePayload": {
+      "name": "string",
+      "path": "string",
+      "previous_revision": "string",
+      "revision": "string",
+      "reason": "string"
+    },
+    "FileChangePayload": {
+      "file": "file",
+      "file_id": "string",
+      "previous_path": "string",
+      "revision": "string"
+    }
+  }
+}