@playcademy/sdk 0.16.1-beta.13 → 0.16.1-beta.14

package/dist/contracts.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The child-catalog contract: what a child game publishes about its
+ * deliverable lessons, per lesson id and level. A parent course authority
+ * resolves its lesson references against this document at compile time and
+ * fails closed at runtime on anything not `ready` in production.
+ *
+ * Ownership and flow: each child repo generates `.playcademy/catalog.json`
+ * from its own registry (`playcademy catalog generate`); a sync workflow
+ * carries copies into parent repos. Children never read the parent's
+ * compiled authority — this file and the launch payload are the entire
+ * surface between them.
+ *
+ * The document deliberately carries no app identity. The consuming repo
+ * assigns the namespace key (e.g. 'form', 'math-cakes') from sync
+ * provenance via its own repo → app map, so a child cannot misdeclare
+ * who it is and a typo cannot mint a phantom namespace.
+ */
+/** Contract identifier carried by every catalog document. */
+declare const CHILD_CATALOG_CONTRACT: 'playcademy-child-catalog-v1';
+/** The completion-evidence contract a catalog declares its runs report. */
+declare const CHILD_ATTEMPT_CONTRACT: 'playcademy-child-attempt-v1';
+/** Delivery levels a catalog may declare (serving-id dialect, lowercase). */
+declare const CATALOG_LEVELS: readonly ['e1', 'e2', 'e3', 'e4'];
+type CatalogLevel = (typeof CATALOG_LEVELS)[number];
+/**
+ * ready: real content. simulated: placeholder — playable for preview and
+ * simulation, never creditable in production. unavailable: intentionally
+ * absent at this level. Consumers must treat unknown values and missing
+ * levels as unavailable (fail closed).
+ */
+declare const CATALOG_READINESS: readonly ['ready', 'simulated', 'unavailable'];
+type CatalogReadiness = (typeof CATALOG_READINESS)[number];
+interface ChildCatalog {
+    /** The contract identifier. */
+    contract: typeof CHILD_CATALOG_CONTRACT;
+    /** The completion-evidence contract a catalog declares its runs report. */
+    evidence: typeof CHILD_ATTEMPT_CONTRACT;
+    /** The tool that generated this document (repo-relative path). */
+    generatedBy: string;
+    /** The in-repo source of truth the document was derived from. */
+    generatedFrom: string;
+    /** Lesson id → level → readiness. */
+    deliveries: Record<string, Partial<Record<CatalogLevel, CatalogReadiness>>>;
+}
+
+export { CATALOG_LEVELS, CATALOG_READINESS, CHILD_ATTEMPT_CONTRACT, CHILD_CATALOG_CONTRACT };
+export type { CatalogLevel, CatalogReadiness, ChildCatalog };

package/dist/contracts.js

@@ -0,0 +1,23 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
+// src/contracts/child-catalog.ts
+var CHILD_CATALOG_CONTRACT = "playcademy-child-catalog-v1";
+var CHILD_ATTEMPT_CONTRACT = "playcademy-child-attempt-v1";
+var CATALOG_LEVELS = ["e1", "e2", "e3", "e4"];
+var CATALOG_READINESS = ["ready", "simulated", "unavailable"];
+export {
+  CHILD_CATALOG_CONTRACT,
+  CHILD_ATTEMPT_CONTRACT,
+  CATALOG_READINESS,
+  CATALOG_LEVELS
+};

package/dist/index.js

@@ -3484,7 +3484,7 @@ async function request({
   return rawText && rawText.length > 0 ? rawText : undefined;
 }
 // src/version.ts
-var SDK_VERSION = "0.16.1-beta.13";
+var SDK_VERSION = "0.16.1-beta.14";
 
 // src/clients/base.ts
 class PlaycademyBaseClient {

package/dist/internal.d.ts

@@ -3489,6 +3489,19 @@ interface DashboardThemeConfig {
     /** Secondary/accent color as a hex string, e.g. '#ffd166' */
     secondary?: string;
 }
+/**
+ * Child-catalog contract generation (see @playcademy/sdk/contracts).
+ * The extractor is a repo-local script (run with the CLI's runtime) that
+ * prints `{ generatedFrom, deliveries }` as JSON on stdout; the CLI
+ * validates, stamps the contract fields, and writes
+ * `.playcademy/catalog.json` deterministically. The document carries no
+ * app identity — consuming repos assign the namespace key from sync
+ * provenance.
+ */
+interface CatalogConfig {
+    /** Path to the extractor script, relative to the config file. */
+    extractor: string;
+}
 /**
  * Unified Playcademy configuration
  * Used for playcademy.config.{js,json}
@@ -3521,6 +3534,8 @@ interface PlaycademyConfig {
     dashboard?: DashboardConfig | boolean;
     /** Integrations (database, custom routes, external services) */
     integrations?: IntegrationsConfig;
+    /** Child-catalog contract generation (`playcademy catalog`) */
+    catalog?: CatalogConfig;
 }
 
 /**

package/dist/internal.js

@@ -4360,7 +4360,7 @@ async function request({
   return rawText && rawText.length > 0 ? rawText : undefined;
 }
 // src/version.ts
-var SDK_VERSION = "0.16.1-beta.13";
+var SDK_VERSION = "0.16.1-beta.14";
 
 // src/clients/base.ts
 class PlaycademyBaseClient {

package/dist/server/edge.d.ts

@@ -142,6 +142,19 @@ interface DashboardThemeConfig {
     /** Secondary/accent color as a hex string, e.g. '#ffd166' */
     secondary?: string;
 }
+/**
+ * Child-catalog contract generation (see @playcademy/sdk/contracts).
+ * The extractor is a repo-local script (run with the CLI's runtime) that
+ * prints `{ generatedFrom, deliveries }` as JSON on stdout; the CLI
+ * validates, stamps the contract fields, and writes
+ * `.playcademy/catalog.json` deterministically. The document carries no
+ * app identity — consuming repos assign the namespace key from sync
+ * provenance.
+ */
+interface CatalogConfig {
+    /** Path to the extractor script, relative to the config file. */
+    extractor: string;
+}
 /**
  * Unified Playcademy configuration
  * Used for playcademy.config.{js,json}
@@ -174,6 +187,8 @@ interface PlaycademyConfig {
     dashboard?: DashboardConfig | boolean;
     /** Integrations (database, custom routes, external services) */
     integrations?: IntegrationsConfig;
+    /** Child-catalog contract generation (`playcademy catalog`) */
+    catalog?: CatalogConfig;
 }
 
 /**

package/dist/server/edge.js

@@ -313,7 +313,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.16.1-beta.13";
+var SDK_VERSION = "0.16.1-beta.14";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/dist/server.d.ts

@@ -142,6 +142,19 @@ interface DashboardThemeConfig {
     /** Secondary/accent color as a hex string, e.g. '#ffd166' */
     secondary?: string;
 }
+/**
+ * Child-catalog contract generation (see @playcademy/sdk/contracts).
+ * The extractor is a repo-local script (run with the CLI's runtime) that
+ * prints `{ generatedFrom, deliveries }` as JSON on stdout; the CLI
+ * validates, stamps the contract fields, and writes
+ * `.playcademy/catalog.json` deterministically. The document carries no
+ * app identity — consuming repos assign the namespace key from sync
+ * provenance.
+ */
+interface CatalogConfig {
+    /** Path to the extractor script, relative to the config file. */
+    extractor: string;
+}
 /**
  * Unified Playcademy configuration
  * Used for playcademy.config.{js,json}
@@ -174,6 +187,8 @@ interface PlaycademyConfig {
     dashboard?: DashboardConfig | boolean;
     /** Integrations (database, custom routes, external services) */
     integrations?: IntegrationsConfig;
+    /** Child-catalog contract generation (`playcademy catalog`) */
+    catalog?: CatalogConfig;
 }
 
 /**

package/dist/server.js

@@ -502,7 +502,7 @@ function extractApiErrorInfo(error) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.16.1-beta.13";
+var SDK_VERSION = "0.16.1-beta.14";
 
 // src/server/request.ts
 async function makeApiRequest(opts) {

package/dist/types.d.ts

@@ -363,6 +363,19 @@ interface DashboardThemeConfig {
     /** Secondary/accent color as a hex string, e.g. '#ffd166' */
     secondary?: string;
 }
+/**
+ * Child-catalog contract generation (see @playcademy/sdk/contracts).
+ * The extractor is a repo-local script (run with the CLI's runtime) that
+ * prints `{ generatedFrom, deliveries }` as JSON on stdout; the CLI
+ * validates, stamps the contract fields, and writes
+ * `.playcademy/catalog.json` deterministically. The document carries no
+ * app identity — consuming repos assign the namespace key from sync
+ * provenance.
+ */
+interface CatalogConfig {
+    /** Path to the extractor script, relative to the config file. */
+    extractor: string;
+}
 /**
  * Unified Playcademy configuration
  * Used for playcademy.config.{js,json}
@@ -395,6 +408,8 @@ interface PlaycademyConfig {
     dashboard?: DashboardConfig | boolean;
     /** Integrations (database, custom routes, external services) */
     integrations?: IntegrationsConfig;
+    /** Child-catalog contract generation (`playcademy catalog`) */
+    catalog?: CatalogConfig;
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sdk",
-    "version": "0.16.1-beta.13",
+    "version": "0.16.1-beta.14",
     "type": "module",
     "exports": {
         ".": {
@@ -21,6 +21,12 @@
             "import": "./dist/types.js",
             "require": "./dist/types.js"
         },
+        "./contracts": {
+            "source": "./src/contracts.ts",
+            "types": "./dist/contracts.d.ts",
+            "import": "./dist/contracts.js",
+            "require": "./dist/contracts.js"
+        },
         "./internal": {
             "source": "./src/internal.ts",
             "types": "./dist/internal.d.ts",