@farthershore/product 0.4.0 → 0.5.0

package/dist/bin.js

@@ -2423,10 +2423,13 @@ function hashIr(ir) {
 }
 
 // src/version.ts
-var SDK_VERSION = true ? "0.4.0" : "0.0.0-dev";
+var SDK_VERSION = true ? "0.5.0" : "0.0.0-dev";
 
 // src/product.ts
 var PRODUCT_BRAND = Symbol.for("farthershore.product.product");
+var PRODUCT_MANIFEST_COMPILER = Symbol.for(
+  "farthershore.product.manifestCompiler"
+);
 function isCapabilityGrant(value) {
   return typeof value === "object" && value !== null && value.kind === "capability_grant";
 }
@@ -2484,7 +2487,7 @@ var Product = class {
   frontend;
   lifecycle;
   offering;
-  /** Escape hatches — raw platform-schema JSON, validated at toIR(). */
+  /** Escape hatches — raw platform-schema JSON, validated by the compiler. */
   raw;
   constructor(name, options) {
     if (!name || typeof name !== "string") {
@@ -2887,9 +2890,9 @@ var Product = class {
   resourceGraph() {
     return this.graph.snapshot();
   }
-  /** Assemble + validate the Manifest IR. Throws ManifestValidationError
-   *  with structured issues when the declared state is invalid. */
-  toIR() {
+  /** @internal Internal platform compiler entrypoint. Builder code exports the
+   *  Product; the bot/CLI/build-runner decide when to compile and apply it. */
+  [PRODUCT_MANIFEST_COMPILER]() {
     const routes = this.materializeFeatureFiles();
     this.assertRouteMeteringValid(routes);
     this.assertGraphDependenciesSatisfied();
@@ -3358,6 +3361,9 @@ var Product = class {
 function isProduct(value) {
   return typeof value === "object" && value !== null && value[PRODUCT_BRAND] === true;
 }
+function compileProductToManifest(product) {
+  return product[PRODUCT_MANIFEST_COMPILER]();
+}
 function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -3487,7 +3493,7 @@ async function main() {
     process.exit(1);
   }
   try {
-    const { ir, irHash } = candidate.toIR();
+    const { ir, irHash } = compileProductToManifest(candidate);
     await writeFile(
       resolve(process.cwd(), args.out),
       `${JSON.stringify({ ir, irHash }, null, 2)}

package/dist/index.js

@@ -2418,10 +2418,13 @@ function canonicalIrJson(ir) {
 }
 
 // src/version.ts
-var SDK_VERSION = true ? "0.4.0" : "0.0.0-dev";
+var SDK_VERSION = true ? "0.5.0" : "0.0.0-dev";
 
 // src/product.ts
 var PRODUCT_BRAND = Symbol.for("farthershore.product.product");
+var PRODUCT_MANIFEST_COMPILER = Symbol.for(
+  "farthershore.product.manifestCompiler"
+);
 function isCapabilityGrant(value) {
   return typeof value === "object" && value !== null && value.kind === "capability_grant";
 }
@@ -2479,7 +2482,7 @@ var Product = class {
   frontend;
   lifecycle;
   offering;
-  /** Escape hatches — raw platform-schema JSON, validated at toIR(). */
+  /** Escape hatches — raw platform-schema JSON, validated by the compiler. */
   raw;
   constructor(name, options) {
     if (!name || typeof name !== "string") {
@@ -2882,9 +2885,9 @@ var Product = class {
   resourceGraph() {
     return this.graph.snapshot();
   }
-  /** Assemble + validate the Manifest IR. Throws ManifestValidationError
-   *  with structured issues when the declared state is invalid. */
-  toIR() {
+  /** @internal Internal platform compiler entrypoint. Builder code exports the
+   *  Product; the bot/CLI/build-runner decide when to compile and apply it. */
+  [PRODUCT_MANIFEST_COMPILER]() {
     const routes = this.materializeFeatureFiles();
     this.assertRouteMeteringValid(routes);
     this.assertGraphDependenciesSatisfied();

package/dist/types/errors.d.ts

@@ -5,9 +5,9 @@ export type ManifestIssue = {
     message: string;
 };
 /**
- * Thrown by `product.toIR()` (and the manifest-build bin) when the
- * assembled manifest fails schema validation. Plain-data `issues` so the
- * error survives serialization across the runner callback boundary.
+ * Thrown by the platform manifest compiler when the assembled manifest fails
+ * schema validation. Plain-data `issues` so the error survives serialization
+ * across the runner callback boundary.
  */
 export declare class ManifestValidationError extends Error {
     readonly issues: ManifestIssue[];

package/dist/types/ir-types.d.ts

@@ -321,7 +321,7 @@ export type ManifestIrDocument = {
         migrations: null;
     };
 };
-/** `toIR()` result: the validated envelope plus its canonical hash. */
+/** Platform compiler result: the validated envelope plus its canonical hash. */
 export type ManifestBuildResult = {
     ir: ManifestIrDocument;
     irHash: string;

package/dist/types/product.d.ts

@@ -1,4 +1,4 @@
-import type { CacheProfile, ActionSpecJson, CapabilityFileJson, FrontendComponentId, FrontendGateMode, FrontendManifestJson, GrantJson, ManifestBuildResult, MeterDefinitionJson, MigrationDeclJson, MigrationPinJson, MutationClass, CountedResourceJson, PlanLimitJson, PlanMeterJson, PlanSpecJson, PolicyFileJson, ProductPoliciesJson, ProductCustomerContextJson, ProductWorkflowKindJson, ProductWorkflowTriggerJson, ProductSurfaceTypeJson, RoutesFileJson } from "./ir-types.js";
+import type { CacheProfile, ActionSpecJson, CapabilityFileJson, FrontendComponentId, FrontendGateMode, FrontendManifestJson, GrantJson, MeterDefinitionJson, MigrationDeclJson, MigrationPinJson, MutationClass, CountedResourceJson, PlanLimitJson, PlanMeterJson, PlanSpecJson, PolicyFileJson, ProductPoliciesJson, ProductCustomerContextJson, ProductWorkflowKindJson, ProductWorkflowTriggerJson, ProductSurfaceTypeJson, RoutesFileJson } from "./ir-types.js";
 import type { PriceSpec } from "./price.js";
 import { type ManifestResourceGraphSnapshot } from "./resource-graph.js";
 /** Brand symbol so the bin can recognize a Product across SDK copies
@@ -282,7 +282,7 @@ export declare class Product {
     readonly offering: {
         plan: (key: string, options: PlanOptions) => PlanRef;
     };
-    /** Escape hatches — raw platform-schema JSON, validated at toIR(). */
+    /** Escape hatches — raw platform-schema JSON, validated by the compiler. */
     readonly raw: {
         /** Deep-merged onto the emitted product spec (usage, webhooks,
          *  environments, add_ons, lifecycle, billing overrides, …). */
@@ -308,9 +308,6 @@ export declare class Product {
     use(...modules: ProductModule[]): Product;
     /** Inspect the SDK-local declaration graph used to emit the Manifest IR. */
     resourceGraph(): ManifestResourceGraphSnapshot;
-    /** Assemble + validate the Manifest IR. Throws ManifestValidationError
-     *  with structured issues when the declared state is invalid. */
-    toIR(): ManifestBuildResult;
     private buildProductSpec;
     private buildMeterDefinitions;
     private routeValueMeterKeys;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farthershore/product",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Farther Shore product-as-code SDK — declare your software product in TypeScript",
   "type": "module",
   "main": "./dist/index.js",