@ankhorage/contracts 1.19.1 → 1.19.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ankhorage/contracts
 
+## 1.19.3
+
+### Patch Changes
+
+- 01a73ed: Update CLI provider metadata examples.
+
+## 1.19.2
+
+### Patch Changes
+
+- 20bd7b6: Add shared runtime callback contracts for node prop resolvers and callback maps.
+
 ## 1.19.1
 
 ### Patch Changes

package/README.md

@@ -88,7 +88,7 @@ provider module path:
 {
   "ankh": {
     "category": "infra",
-    "provider": "./dist/ankh.provider.js",
+    "provider": "./dist/cli/index.js",
     "capabilities": ["infra.up", "infra.status"]
   }
 }

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export * from './data';
 export * from './db';
 export * from './nutrition';
 export * from './requirements';
+export * from './runtimeCallbacks';
 export * from './state';
 export * from './storage';
 export * from './types';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,MAAM,CAAC;AACrB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,MAAM,CAAC;AACrB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,MAAM,CAAC"}

package/dist/index.js

@@ -5,6 +5,7 @@ export * from './data';
 export * from './db';
 export * from './nutrition';
 export * from './requirements';
+export * from './runtimeCallbacks';
 export * from './state';
 export * from './storage';
 export * from './types';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,MAAM,CAAC;AACrB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,MAAM,CAAC","sourcesContent":["export * from './auth';\nexport * from './bindings';\nexport * from './cli';\nexport * from './data';\nexport * from './db';\nexport * from './nutrition';\nexport * from './requirements';\nexport * from './state';\nexport * from './storage';\nexport * from './types';\nexport * from './ui';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,MAAM,CAAC;AACrB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,MAAM,CAAC","sourcesContent":["export * from './auth';\nexport * from './bindings';\nexport * from './cli';\nexport * from './data';\nexport * from './db';\nexport * from './nutrition';\nexport * from './requirements';\nexport * from './runtimeCallbacks';\nexport * from './state';\nexport * from './storage';\nexport * from './types';\nexport * from './ui';\n"]}

package/dist/runtimeCallbacks.d.ts

@@ -0,0 +1,14 @@
+import type { UiNode } from './types';
+export interface RuntimeResolveNodePropsArgs {
+    readonly node: UiNode;
+    readonly props: Record<string, unknown>;
+}
+export type RuntimeNodePropsResolver = (args: RuntimeResolveNodePropsArgs) => Record<string, unknown>;
+export interface RuntimeCallbackArgs {
+    readonly payload: unknown;
+    readonly node?: UiNode;
+    readonly resolvedPayload?: object;
+}
+export type RuntimeCallback = (args: RuntimeCallbackArgs) => Promise<void> | void;
+export type RuntimeCallbackMap = Readonly<Record<string, RuntimeCallback>>;
+//# sourceMappingURL=runtimeCallbacks.d.ts.map

package/dist/runtimeCallbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeCallbacks.d.ts","sourceRoot":"","sources":["../src/runtimeCallbacks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,MAAM,wBAAwB,GAAG,CACrC,IAAI,EAAE,2BAA2B,KAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAClF,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC"}

package/dist/runtimeCallbacks.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtimeCallbacks.js.map

package/dist/runtimeCallbacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeCallbacks.js","sourceRoot":"","sources":["../src/runtimeCallbacks.ts"],"names":[],"mappings":"","sourcesContent":["import type { UiNode } from './types';\n\nexport interface RuntimeResolveNodePropsArgs {\n  readonly node: UiNode;\n  readonly props: Record<string, unknown>;\n}\n\nexport type RuntimeNodePropsResolver = (\n  args: RuntimeResolveNodePropsArgs,\n) => Record<string, unknown>;\n\nexport interface RuntimeCallbackArgs {\n  readonly payload: unknown;\n  readonly node?: UiNode;\n  readonly resolvedPayload?: object;\n}\n\nexport type RuntimeCallback = (args: RuntimeCallbackArgs) => Promise<void> | void;\nexport type RuntimeCallbackMap = Readonly<Record<string, RuntimeCallback>>;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/contracts",
-  "version": "1.19.1",
+  "version": "1.19.3",
   "main": "./dist/index.js",
   "ankh": {
     "category": "contracts",
@@ -48,6 +48,10 @@
       "types": "./dist/nutrition/index.d.ts",
       "default": "./dist/nutrition/index.js"
     },
+    "./runtime": {
+      "types": "./dist/runtimeCallbacks.d.ts",
+      "default": "./dist/runtimeCallbacks.js"
+    },
     "./state": {
       "types": "./dist/state.d.ts",
       "default": "./dist/state.js"

package/src/cli.test.ts

@@ -11,7 +11,7 @@ describe('cli contracts', () => {
   it('accepts provider package metadata and provider manifests', () => {
     const packageMetadata = {
       category: 'infra',
-      provider: './dist/ankh.provider.js',
+      provider: './dist/cli/index.js',
       capabilities: ['infra.up', 'infra.status'],
     } as const satisfies AnkhPackageMetadata;
 

package/src/index.ts

@@ -5,6 +5,7 @@ export * from './data';
 export * from './db';
 export * from './nutrition';
 export * from './requirements';
+export * from './runtimeCallbacks';
 export * from './state';
 export * from './storage';
 export * from './types';

package/src/runtimeCallbacks.ts

@@ -0,0 +1,19 @@
+import type { UiNode } from './types';
+
+export interface RuntimeResolveNodePropsArgs {
+  readonly node: UiNode;
+  readonly props: Record<string, unknown>;
+}
+
+export type RuntimeNodePropsResolver = (
+  args: RuntimeResolveNodePropsArgs,
+) => Record<string, unknown>;
+
+export interface RuntimeCallbackArgs {
+  readonly payload: unknown;
+  readonly node?: UiNode;
+  readonly resolvedPayload?: object;
+}
+
+export type RuntimeCallback = (args: RuntimeCallbackArgs) => Promise<void> | void;
+export type RuntimeCallbackMap = Readonly<Record<string, RuntimeCallback>>;