@telorun/sdk 0.33.0 → 0.34.0

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from "./cancellation.js";
 export * from "./compiled-value.js";
 export * from "./capabilities/invokable.js";
 export * from "./ref.js";
+export * from "./type-schema-ref.js";
 export * from "./invoke-step.js";
 export * from "./dispatch-invoke-ref.js";
 export * from "./capabilities/provider.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -2,6 +2,7 @@ export * from "./cancellation.js";
 export * from "./compiled-value.js";
 export * from "./capabilities/invokable.js";
 export * from "./ref.js";
+export * from "./type-schema-ref.js";
 export * from "./invoke-step.js";
 export * from "./dispatch-invoke-ref.js";
 export * from "./capabilities/provider.js";

package/dist/type-schema-ref.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Module-scoped schema references for JSON Schema `$ref`.
+ *
+ * A `Type.JsonSchema` (or any `Telo.Type`) resource registers its schema under a
+ * canonical URI `$id` of `telo://<module>/<typeName>`, so other schemas can
+ * reference it with a standard JSON Schema `$ref`. Authors write the reference
+ * through an import — `telo://Self/<typeName>` for the declaring module's own
+ * type, or `telo://<Alias>/<typeName>` for an imported module's type — and the
+ * loader rewrites the authority (`Self` / alias) to the resolved module name.
+ * The version is carried by the `imports:` entry, never by the URI: only the
+ * pinned version is ever loaded, so the canonical id stays version-free.
+ */
+export declare const TELO_TYPE_SCHEME = "telo://";
+/** The canonical, alias-resolved `$id` a named type schema is registered under. */
+export declare function canonicalTypeSchemaId(moduleName: string, typeName: string): string;
+/** Parsed parts of a `telo://<authority>/<typeName>` schema reference. */
+export interface TeloTypeRef {
+    authority: string;
+    typeName: string;
+}
+/**
+ * Parse a `telo://<authority>/<typeName>` schema `$ref`. Returns null for any
+ * other string — notably fragment-bearing built-ins like
+ * `telo://manifest#/$defs/ResourceRef`, which carry no `authority/type` path and
+ * must be left untouched.
+ */
+export declare function parseTeloTypeRef(ref: unknown): TeloTypeRef | null;
+//# sourceMappingURL=type-schema-ref.d.ts.map

package/dist/type-schema-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-schema-ref.d.ts","sourceRoot":"","sources":["../src/type-schema-ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElF;AAED,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAKjE"}

package/dist/type-schema-ref.js

@@ -0,0 +1,31 @@
+/**
+ * Module-scoped schema references for JSON Schema `$ref`.
+ *
+ * A `Type.JsonSchema` (or any `Telo.Type`) resource registers its schema under a
+ * canonical URI `$id` of `telo://<module>/<typeName>`, so other schemas can
+ * reference it with a standard JSON Schema `$ref`. Authors write the reference
+ * through an import — `telo://Self/<typeName>` for the declaring module's own
+ * type, or `telo://<Alias>/<typeName>` for an imported module's type — and the
+ * loader rewrites the authority (`Self` / alias) to the resolved module name.
+ * The version is carried by the `imports:` entry, never by the URI: only the
+ * pinned version is ever loaded, so the canonical id stays version-free.
+ */
+export const TELO_TYPE_SCHEME = "telo://";
+/** The canonical, alias-resolved `$id` a named type schema is registered under. */
+export function canonicalTypeSchemaId(moduleName, typeName) {
+    return `${TELO_TYPE_SCHEME}${moduleName}/${typeName}`;
+}
+/**
+ * Parse a `telo://<authority>/<typeName>` schema `$ref`. Returns null for any
+ * other string — notably fragment-bearing built-ins like
+ * `telo://manifest#/$defs/ResourceRef`, which carry no `authority/type` path and
+ * must be left untouched.
+ */
+export function parseTeloTypeRef(ref) {
+    if (typeof ref !== "string")
+        return null;
+    const match = /^telo:\/\/([^/#]+)\/([^#/]+)$/.exec(ref);
+    if (!match)
+        return null;
+    return { authority: match[1], typeName: match[2] };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telorun/sdk",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "Telo SDK - Public API for Telo module authors.",
   "keywords": [
     "telo",

package/src/index.ts

@@ -2,6 +2,7 @@ export * from "./cancellation.js";
 export * from "./compiled-value.js";
 export * from "./capabilities/invokable.js";
 export * from "./ref.js";
+export * from "./type-schema-ref.js";
 export * from "./invoke-step.js";
 export * from "./dispatch-invoke-ref.js";
 export * from "./capabilities/provider.js";

package/src/type-schema-ref.ts

@@ -0,0 +1,38 @@
+/**
+ * Module-scoped schema references for JSON Schema `$ref`.
+ *
+ * A `Type.JsonSchema` (or any `Telo.Type`) resource registers its schema under a
+ * canonical URI `$id` of `telo://<module>/<typeName>`, so other schemas can
+ * reference it with a standard JSON Schema `$ref`. Authors write the reference
+ * through an import — `telo://Self/<typeName>` for the declaring module's own
+ * type, or `telo://<Alias>/<typeName>` for an imported module's type — and the
+ * loader rewrites the authority (`Self` / alias) to the resolved module name.
+ * The version is carried by the `imports:` entry, never by the URI: only the
+ * pinned version is ever loaded, so the canonical id stays version-free.
+ */
+
+export const TELO_TYPE_SCHEME = "telo://";
+
+/** The canonical, alias-resolved `$id` a named type schema is registered under. */
+export function canonicalTypeSchemaId(moduleName: string, typeName: string): string {
+  return `${TELO_TYPE_SCHEME}${moduleName}/${typeName}`;
+}
+
+/** Parsed parts of a `telo://<authority>/<typeName>` schema reference. */
+export interface TeloTypeRef {
+  authority: string;
+  typeName: string;
+}
+
+/**
+ * Parse a `telo://<authority>/<typeName>` schema `$ref`. Returns null for any
+ * other string — notably fragment-bearing built-ins like
+ * `telo://manifest#/$defs/ResourceRef`, which carry no `authority/type` path and
+ * must be left untouched.
+ */
+export function parseTeloTypeRef(ref: unknown): TeloTypeRef | null {
+  if (typeof ref !== "string") return null;
+  const match = /^telo:\/\/([^/#]+)\/([^#/]+)$/.exec(ref);
+  if (!match) return null;
+  return { authority: match[1], typeName: match[2] };
+}