@absolutejs/billing 0.2.2 → 0.3.0

package/dist/manifest.d.ts

@@ -3,5 +3,13 @@ type BillingRuntime = {
     plan: Plan;
     balances?: ProviderBalanceConfig;
 };
-export declare const manifest: import("@absolutejs/manifest").PackageManifest<Record<never, never>, BillingRuntime>;
+export declare const manifest: Omit<import("@absolutejs/manifest").PackageManifest<Record<never, never>, BillingRuntime>, "contract" | "settings" | "tools"> & (({
+    contract: 1;
+    tools?: Record<string, import("@absolutejs/manifest").LegacyManifestTool<BillingRuntime>> | undefined;
+} | {
+    contract: 2;
+    tools?: Record<string, import("@absolutejs/manifest").AuthorizedManifestTool<BillingRuntime>> | undefined;
+}) & {
+    settings: import("@sinclair/typebox").TObject<{}>;
+});
 export {};

package/dist/manifest.js

@@ -516,14 +516,19 @@ var __export2 = (target, all) => {
       set: __exportSetter2.bind(all, name)
     });
 };
-var defineManifest = () => (manifest) => {
-  const defined = manifest;
-  return defined;
+var defineManifest = () => (manifest) => manifest;
+var literal = (value) => value;
+var RUNTIME_KIND = literal("runtime");
+var WORKSPACE_KIND = literal("workspace");
+var toolFactory = () => {
+  function runtime(definition) {
+    return { kind: RUNTIME_KIND, ...definition };
+  }
+  function workspace(definition) {
+    return { kind: WORKSPACE_KIND, ...definition };
+  }
+  return { runtime, workspace };
 };
-var toolFactory = () => ({
-  runtime: (definition) => ({ kind: "runtime", ...definition }),
-  workspace: (definition) => ({ kind: "workspace", ...definition })
-});
 function IsAsyncIterator(value) {
   return IsObject(value) && globalThis.Symbol.asyncIterator in value;
 }
@@ -1261,7 +1266,7 @@ function String2(options) {
 function* FromUnion(syntax) {
   const trim = syntax.trim().replace(/"|'/g, "");
   return trim === "boolean" ? yield Boolean() : trim === "number" ? yield Number2() : trim === "bigint" ? yield BigInt2() : trim === "string" ? yield String2() : yield (() => {
-    const literals = trim.split("|").map((literal) => Literal(literal.trim()));
+    const literals = trim.split("|").map((literal2) => Literal(literal2.trim()));
     return literals.length === 0 ? Never() : literals.length === 1 ? literals[0] : UnionEvaluated(literals);
   })();
 }
@@ -3969,10 +3974,10 @@ function ScoreUnion(schema, references, value) {
     const keys = Object.getOwnPropertyNames(value);
     const entries = Object.entries(object.properties);
     return entries.reduce((acc, [key, schema2]) => {
-      const literal = schema2[Kind] === "Literal" && schema2.const === value[key] ? 100 : 0;
+      const literal2 = schema2[Kind] === "Literal" && schema2.const === value[key] ? 100 : 0;
       const checks = Check(schema2, references, value[key]) ? 10 : 0;
       const exists = keys.includes(key) ? 1 : 0;
-      return acc + (literal + checks + exists);
+      return acc + (literal2 + checks + exists);
     }, 0);
   } else if (schema[Kind] === "Union") {
     const schemas = schema.anyOf.map((schema2) => Deref(schema2, references));
@@ -6309,7 +6314,13 @@ var wiringSnippet = Type.Object({
     Type.Literal("server-plugin")
   ]))
 });
-var clientFrameworks = ["angular", "client", "react", "svelte", "vue"];
+var clientFrameworks = [
+  "angular",
+  "client",
+  "react",
+  "svelte",
+  "vue"
+];
 var wiringRecipe = Type.Object({
   client: Type.Optional(Type.Partial(Type.Object(Object.fromEntries(clientFrameworks.map((framework) => [framework, wiringSnippet]))))),
   description: Type.Optional(Type.String()),
@@ -6374,8 +6385,47 @@ var toolAnnotations = Type.Object({
   readOnlyHint: Type.Optional(Type.Boolean()),
   title: Type.Optional(Type.String())
 });
+var toolAuthorization = Type.Object({
+  approval: Type.Union([
+    Type.Literal("always"),
+    Type.Literal("never"),
+    Type.Literal("policy")
+  ]),
+  audience: Type.Union([
+    Type.Literal("admin"),
+    Type.Literal("authenticated"),
+    Type.Literal("owner"),
+    Type.Literal("public")
+  ]),
+  compensatingTool: Type.Optional(Type.String({ pattern: TOOL_NAME_PATTERN.source })),
+  destinationFields: Type.Optional(Type.Array(Type.String({ minLength: 1 }), { minItems: 1 })),
+  destinations: Type.Optional(Type.Array(Type.String({ minLength: 1 }), { minItems: 1 })),
+  effects: Type.Array(Type.String({ minLength: 1 }), { minItems: 1 }),
+  idempotency: Type.Optional(Type.Union([
+    Type.Object({
+      field: Type.String({ minLength: 1 }),
+      mode: Type.Literal("field")
+    }),
+    Type.Object({ mode: Type.Literal("host") }),
+    Type.Object({ mode: Type.Literal("resource") })
+  ])),
+  requiredScopes: Type.Optional(Type.Array(Type.String({ minLength: 1 }), { minItems: 1 })),
+  resource: Type.Optional(Type.Object({
+    idField: Type.Optional(Type.String({ minLength: 1 })),
+    ownerIdField: Type.Optional(Type.String({ minLength: 1 })),
+    tenantIdField: Type.Optional(Type.String({ minLength: 1 })),
+    type: Type.String({ minLength: 1 })
+  })),
+  reversible: Type.Optional(Type.Boolean()),
+  spend: Type.Optional(Type.Object({
+    amountMinorField: Type.String({ minLength: 1 }),
+    currencyField: Type.String({ minLength: 1 }),
+    maximumAmountMinor: Type.Optional(Type.Integer({ minimum: 0 }))
+  }))
+});
 var serializedTool = Type.Object({
   annotations: Type.Optional(toolAnnotations),
+  authorization: Type.Optional(toolAuthorization),
   capabilities: Type.Optional(Type.Array(Type.Union([
     Type.Literal("exec"),
     Type.Literal("glob"),
@@ -6387,7 +6437,15 @@ var serializedTool = Type.Object({
   kind: Type.Union([Type.Literal("runtime"), Type.Literal("workspace")])
 });
 var manifestSchema = Type.Object({
-  contract: Type.Literal(1),
+  contract: Type.Union([Type.Literal(1), Type.Literal(2)]),
+  discovery: Type.Optional(Type.Object({
+    audiences: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
+    certificationUrl: Type.Optional(Type.String()),
+    intents: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
+    keywords: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
+    protocols: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
+    url: Type.Optional(Type.String())
+  })),
   identity: Type.Object({
     accent: Type.Optional(Type.String({ pattern: "^#[0-9a-fA-F]{3,8}$" })),
     category: Type.String({ minLength: 1 }),
@@ -6397,7 +6455,9 @@ var manifestSchema = Type.Object({
       svg: Type.Optional(Type.String()),
       url: Type.Optional(Type.String())
     })),
-    name: Type.String({ pattern: "^(@[a-z0-9-~][a-z0-9-._~]*/)?[a-z0-9-~][a-z0-9-._~]*$" }),
+    name: Type.String({
+      pattern: "^(@[a-z0-9-~][a-z0-9-._~]*/)?[a-z0-9-~][a-z0-9-._~]*$"
+    }),
     tagline: Type.String({ minLength: 1 })
   }),
   implements: Type.Optional(Type.Array(adapterImplementation)),
@@ -7370,7 +7430,7 @@ function String3(options) {
 function* FromUnion21(syntax) {
   const trim = syntax.trim().replace(/"|'/g, "");
   return trim === "boolean" ? yield Boolean2() : trim === "number" ? yield Number3() : trim === "bigint" ? yield BigInt3() : trim === "string" ? yield String3() : yield (() => {
-    const literals = trim.split("|").map((literal) => Literal2(literal.trim()));
+    const literals = trim.split("|").map((literal2) => Literal2(literal2.trim()));
     return literals.length === 0 ? Never2() : literals.length === 1 ? literals[0] : UnionEvaluated2(literals);
   })();
 }
@@ -8972,7 +9032,7 @@ var DEFAULT_PREVIEW_DAYS = 30;
 var MAX_PREVIEW_DAYS = 366;
 var tool = toolFactory();
 var manifest = defineManifest()({
-  contract: 1,
+  contract: 2,
   identity: {
     accent: "#f59e0b",
     category: "commerce",
@@ -9005,6 +9065,12 @@ var manifest = defineManifest()({
   tools: {
     explain_plan: tool.runtime({
       annotations: { readOnlyHint: true },
+      authorization: {
+        approval: "never",
+        audience: "authenticated",
+        effects: ["read"],
+        requiredScopes: ["billing:read"]
+      },
       description: "Describe the app's pricing plan: base fee, per-dimension unit prices or tier tables, free-tier allowances, rounding, and minimum charge. Amounts are integer micros (1,000,000 micros = 1 currency unit). Custom function-priced dimensions are reported as 'custom'.",
       handler: (_input, { plan }) => {
         const dimensions = Object.entries(plan.pricedDimensions).map(([key, dim]) => ({
@@ -9027,6 +9093,13 @@ var manifest = defineManifest()({
     }),
     preview_invoice: tool.runtime({
       annotations: { idempotentHint: true, readOnlyHint: true },
+      authorization: {
+        approval: "never",
+        audience: "owner",
+        effects: ["read"],
+        requiredScopes: ["billing:preview"],
+        resource: { idField: "tenant", tenantIdField: "tenant", type: "billing-preview" }
+      },
       description: "Dry-run an invoice: price a usage snapshot through the app's plan and return the line items and total in integer micros. Pure math \u2014 nothing is charged or stored. Usage keys must match the plan's priced dimensions.",
       handler: ({ periodDays, tenant, usage }, { plan }) => {
         const end = Date.now();
@@ -9056,7 +9129,16 @@ var manifest = defineManifest()({
       })
     }),
     provider_balances: tool.runtime({
-      annotations: { openWorldHint: true, readOnlyHint: true },
+      annotations: { idempotentHint: true, openWorldHint: true },
+      authorization: {
+        approval: "policy",
+        audience: "admin",
+        destinations: ["configured-billing-provider"],
+        effects: ["read", "external-network"],
+        idempotency: { mode: "host" },
+        requiredScopes: ["billing:providers:read"],
+        reversible: false
+      },
       description: "Read each configured upstream vendor's OWN reported balance, quota, or spend (Anthropic/OpenAI report spend; Twilio/Deepgram report balance; ElevenLabs/Apollo report quota). Free reporting endpoints \u2014 no per-call charge. Reports only the providers the host wired credentials for.",
       handler: async (_input, { balances }) => balances === undefined ? "no provider credentials are wired \u2014 wire a ProviderBalanceConfig (see the provider-balances recipe)" : JSON.stringify(await readProviderBalances(balances)),
       input: Type2.Object({})
@@ -9104,5 +9186,5 @@ export {
   manifest
 };
 
-//# debugId=B0E122DF0D110CFA64756E2164756E21
+//# debugId=22773D62A08DEEC264756E2164756E21
 //# sourceMappingURL=manifest.js.map