@siglume/api-sdk 0.10.6 → 0.10.8

package/dist/index.js

@@ -1537,6 +1537,56 @@ var init_operations = __esm({
 });
 
 // src/client.ts
+function validateManifestPersistenceContract(payload) {
+  const vertical = String(payload.store_vertical ?? "").trim().toLowerCase();
+  const persistence = payload.persistence;
+  if (persistence === void 0 || persistence === null) {
+    return;
+  }
+  if (!isRecord2(persistence)) {
+    throw new SiglumeClientError("AppManifest.persistence must be an object.");
+  }
+  const mode = String(persistence.mode ?? (vertical === "game" ? "platform" : "none")).trim().toLowerCase();
+  if (!["none", "local", "platform", "developer_server"].includes(mode)) {
+    throw new SiglumeClientError(
+      "AppManifest.persistence.mode must be one of: none, local, platform, developer_server."
+    );
+  }
+  const schema = persistence.save_data_schema;
+  if (vertical === "game" && mode !== "none" && schema === void 0) {
+    throw new SiglumeClientError(
+      "AppManifest.persistence.save_data_schema is required when store_vertical='game' and persistence.mode is not 'none'."
+    );
+  }
+  if (schema !== void 0) {
+    validateSaveDataSchema(schema, "AppManifest.persistence.save_data_schema");
+  }
+}
+function validateSaveDataSchema(schema, fieldName) {
+  if (!isRecord2(schema)) {
+    throw new SiglumeClientError(`${fieldName} must be a JSON Schema object.`);
+  }
+  const schemaSize = new TextEncoder().encode(JSON.stringify(schema)).length;
+  if (schemaSize > 8192) {
+    throw new SiglumeClientError(`${fieldName} must be at most 8192 bytes.`);
+  }
+  if (schema.type !== "object") {
+    throw new SiglumeClientError(`${fieldName}.type must be 'object'.`);
+  }
+  const properties = schema.properties;
+  if (!isRecord2(properties) || Object.keys(properties).length === 0) {
+    throw new SiglumeClientError(`${fieldName}.properties must be a non-empty object.`);
+  }
+  if (schema.required !== void 0) {
+    if (!Array.isArray(schema.required) || !schema.required.every((item) => typeof item === "string")) {
+      throw new SiglumeClientError(`${fieldName}.required must be an array of strings when provided.`);
+    }
+    const missing = schema.required.filter((item) => !(item in properties));
+    if (missing.length > 0) {
+      throw new SiglumeClientError(`${fieldName}.required references undefined properties: ${missing.join(", ")}.`);
+    }
+  }
+}
 function buildToolManualQualityReport(payload) {
   const qualityBlock = isRecord2(payload.quality) ? payload.quality : payload;
   const issues = [];
@@ -1611,6 +1661,8 @@ function buildUrl(baseUrl, path, params) {
   return url.toString();
 }
 function parseListing(data) {
+  const metadata = isRecord2(data.metadata) ? data.metadata : {};
+  const persistence = isRecord2(data.persistence) ? data.persistence : isRecord2(metadata.persistence) ? metadata.persistence : {};
   return {
     listing_id: String(data.listing_id ?? data.id ?? ""),
     capability_key: String(data.capability_key ?? ""),
@@ -1624,6 +1676,8 @@ function parseListing(data) {
     price_model: stringOrNull2(data.price_model),
     price_value_minor: Number(data.price_value_minor ?? 0),
     currency: String(data.currency ?? "USD"),
+    allow_free_trial: Boolean(data.allow_free_trial ?? false),
+    free_trial_duration_days: Number(data.free_trial_duration_days ?? 30),
     short_description: stringOrNull2(data.short_description),
     description: stringOrNull2(data.description),
     docs_url: stringOrNull2(data.docs_url),
@@ -1631,14 +1685,59 @@ function parseListing(data) {
     seller_display_name: stringOrNull2(data.seller_display_name),
     seller_homepage_url: stringOrNull2(data.seller_homepage_url),
     seller_social_url: stringOrNull2(data.seller_social_url),
+    publisher_type: stringOrNull2(data.publisher_type),
+    publisher_company_id: stringOrNull2(data.publisher_company_id),
+    company_id: stringOrNull2(data.company_id),
+    company_name: stringOrNull2(data.company_name),
+    company_publish_status: stringOrNull2(data.company_publish_status),
+    company_terms_version: stringOrNull2(data.company_terms_version),
     review_status: stringOrNull2(data.review_status),
     review_note: stringOrNull2(data.review_note),
     submission_blockers: Array.isArray(data.submission_blockers) ? data.submission_blockers.filter((item) => typeof item === "string") : [],
+    persistence: { ...persistence },
     created_at: stringOrNull2(data.created_at),
     updated_at: stringOrNull2(data.updated_at),
     raw: { ...data }
   };
 }
+function parseCompanyPublisher(data) {
+  const wallets = Array.isArray(data.settlement_wallets) ? data.settlement_wallets.filter((item) => isRecord2(item)) : [];
+  return {
+    company_id: String(data.company_id ?? data.id ?? ""),
+    name: String(data.name ?? ""),
+    status: String(data.status ?? ""),
+    description: stringOrNull2(data.description),
+    is_founder: Boolean(data.is_founder ?? false),
+    membership_role: stringOrNull2(data.membership_role),
+    membership_status: stringOrNull2(data.membership_status),
+    can_publish: Boolean(data.can_publish ?? true),
+    can_approve: Boolean(data.can_approve ?? false),
+    approval_required: Boolean(data.approval_required ?? false),
+    paid_listing_allowed: Boolean(data.paid_listing_allowed ?? false),
+    disabled_reasons: Array.isArray(data.disabled_reasons) ? data.disabled_reasons.filter((item) => typeof item === "string") : [],
+    company_terms_version: stringOrNull2(data.company_terms_version),
+    active_listing_count: Number(data.active_listing_count ?? 0),
+    pending_approval_count: Number(data.pending_approval_count ?? 0),
+    settlement_wallet_ready: Boolean(data.settlement_wallet_ready ?? false),
+    settlement_wallets: wallets.map((item) => ({ ...item })),
+    raw: { ...data }
+  };
+}
+function parseCapabilitySaveState(data) {
+  return {
+    capability_key: String(data.capability_key ?? ""),
+    save_key: String(data.save_key ?? ""),
+    schema_version: String(data.schema_version ?? "1"),
+    revision: Number(data.revision ?? 0),
+    payload: toRecord2(data.payload),
+    metadata: toRecord2(data.metadata),
+    checksum: stringOrNull2(data.checksum),
+    updated_at: stringOrNull2(data.updated_at),
+    created_at: stringOrNull2(data.created_at),
+    exists: Boolean(data.exists ?? false),
+    raw: { ...data }
+  };
+}
 function parseBundleMember(data) {
   return {
     capability_listing_id: String(data.capability_listing_id ?? ""),
@@ -2818,17 +2917,23 @@ var init_client = __esm({
           "support_contact",
           "seller_homepage_url",
           "seller_social_url",
+          "publisher_type",
+          "company_id",
+          "publisher_company_id",
           "store_vertical",
           "jurisdiction",
           "price_model",
           "price_value_minor",
           "currency",
+          "allow_free_trial",
+          "free_trial_duration_days",
           "permission_class",
           "approval_mode",
           "dry_run_supported",
           "required_connected_accounts",
           "permission_scopes",
-          "compatibility_tags"
+          "compatibility_tags",
+          "persistence"
         ]) {
           const value = manifestPayload[fieldName];
           if (value !== void 0 && value !== null) {
@@ -2850,6 +2955,44 @@ var init_client = __esm({
           throw new SiglumeClientError(`AppManifest.currency must be 'USD' or 'JPY'. Got ${String(payload.currency)}.`);
         }
         payload.currency = currency;
+        if (payload.allow_free_trial === void 0 || payload.allow_free_trial === null) {
+          throw new SiglumeClientError(
+            "AppManifest.allow_free_trial is required. Pass true to offer a Plus/Pro buyer free trial or false to disable trials."
+          );
+        }
+        if (Boolean(payload.allow_free_trial)) {
+          const duration = payload.free_trial_duration_days ?? 30;
+          if (typeof duration !== "number" || !Number.isInteger(duration)) {
+            throw new SiglumeClientError(
+              "AppManifest.free_trial_duration_days must be an integer when allow_free_trial=true."
+            );
+          }
+          if (duration < 1 || duration > 90) {
+            throw new SiglumeClientError(
+              `AppManifest.free_trial_duration_days must be between 1 and 90 when allow_free_trial=true, got: ${duration}.`
+            );
+          }
+        }
+        const explicitPublisherType = payload.publisher_type !== void 0 && payload.publisher_type !== null;
+        const companyId = String(payload.company_id ?? "").trim() || String(payload.publisher_company_id ?? "").trim();
+        const publisherType = String(payload.publisher_type ?? "user").trim().toLowerCase();
+        if (publisherType !== "user" && publisherType !== "company") {
+          throw new SiglumeClientError("AppManifest.publisher_type must be 'user' or 'company'.");
+        }
+        if (publisherType === "company" && !companyId) {
+          throw new SiglumeClientError("AppManifest.company_id is required when publisher_type='company'.");
+        }
+        if (publisherType === "user" && companyId) {
+          throw new SiglumeClientError("AppManifest.company_id cannot be combined with publisher_type='user'.");
+        }
+        if (explicitPublisherType || companyId) {
+          payload.publisher_type = publisherType;
+        }
+        if (companyId) {
+          payload.company_id = companyId;
+          payload.publisher_company_id = companyId;
+        }
+        validateManifestPersistenceContract(payload);
         if (payload.manifest && typeof payload.manifest === "object") {
           delete payload.manifest.version;
         }
@@ -2957,6 +3100,45 @@ var init_client = __esm({
         const [data] = await this.request("GET", `/market/capabilities/${listing_id}`);
         return parseListing(data);
       }
+      async list_company_publishers() {
+        const [data] = await this.request("GET", "/market/company-publishers");
+        return Array.isArray(data.items) ? data.items.filter((item) => isRecord2(item)).map(parseCompanyPublisher) : [];
+      }
+      async request_company_publish_approval(listing_id, note) {
+        const [data] = await this.request("POST", `/market/capabilities/${listing_id}/company-publish-approval`, {
+          json_body: note ? { note } : {}
+        });
+        return parseListing(data);
+      }
+      async decide_company_publish_approval(listing_id, options) {
+        const [data] = await this.request("POST", `/market/capabilities/${listing_id}/company-publish-approval/decision`, {
+          json_body: {
+            decision: options.decision,
+            ...options.reason ? { reason: options.reason } : {}
+          }
+        });
+        return parseListing(data);
+      }
+      async get_capability_state(capability_key, save_key = "default") {
+        const [data] = await this.request("GET", `/market/capability-state/${capability_key}/${save_key}`);
+        return parseCapabilitySaveState(data);
+      }
+      async put_capability_state(capability_key, save_key = "default", payload = {}, options = {}) {
+        const body = {
+          payload: toRecord2(payload),
+          schema_version: options.schema_version ?? "1",
+          metadata: toRecord2(options.metadata)
+        };
+        if (options.expected_revision !== void 0 && options.expected_revision !== null) {
+          body.expected_revision = Math.trunc(options.expected_revision);
+        }
+        const [data] = await this.request("PUT", `/market/capability-state/${capability_key}/${save_key}`, { json_body: body });
+        return parseCapabilitySaveState(data);
+      }
+      async delete_capability_state(capability_key, save_key = "default") {
+        const [data] = await this.request("DELETE", `/market/capability-state/${capability_key}/${save_key}`);
+        return parseCapabilitySaveState(data);
+      }
       // ----- Capability bundles (v0.7 track 2) ---------------------------------
       async list_bundles(options = {}) {
         const params = {
@@ -5248,6 +5430,55 @@ var SiglumeBuyerClient = class {
       }
     };
   }
+  async start_trial(options) {
+    const listing = await this.get_listing(options.capability_key);
+    const [data, meta] = await this.request("POST", `/market/capabilities/${listing.listing_id}/start-trial`, {
+      json_body: {}
+    });
+    const accessGrant = parseAccessGrant2(toRecord2(data.access_grant));
+    if (!accessGrant.access_grant_id) {
+      const purchaseStatus = String(data.purchase_status ?? "trial_started");
+      throw new SiglumeExperimentalError(
+        `Trial started with status '${purchaseStatus}' but did not return an access grant. Buyer-side trial flows are still experimental on the public API.`
+      );
+    }
+    const targetAgentId = resolveAgentId(options.agent_id, this.default_agent_id);
+    const shouldBind = options.bind_agent ?? Boolean(targetAgentId);
+    let binding = null;
+    let trace_id = meta.trace_id ?? void 0;
+    let request_id = meta.request_id ?? void 0;
+    if (shouldBind) {
+      if (!targetAgentId) {
+        throw new SiglumeClientError("agent_id is required to bind a trial access grant.");
+      }
+      const grantBinding = await this.client.bind_agent_to_grant(accessGrant.access_grant_id, {
+        agent_id: targetAgentId,
+        binding_status: options.binding_status ?? "active"
+      });
+      binding = grantBinding.binding;
+      trace_id = grantBinding.trace_id ?? trace_id;
+      request_id = grantBinding.request_id ?? request_id;
+    }
+    return {
+      access_grant_id: accessGrant.access_grant_id,
+      capability_listing_id: accessGrant.capability_listing_id ?? listing.listing_id,
+      capability_key: listing.capability_key,
+      purchase_status: String(data.purchase_status ?? "trial_started"),
+      grant_status: accessGrant.grant_status,
+      agent_id: binding?.agent_id ?? targetAgentId ?? null,
+      binding_id: binding?.binding_id ?? null,
+      binding_status: binding?.binding_status ?? null,
+      access_grant: accessGrant,
+      binding,
+      trace_id,
+      request_id,
+      raw: { trial: { ...data }, binding }
+    };
+  }
+  async get_trial_quota() {
+    const [data] = await this.request("GET", "/market/me/trial-quota");
+    return { ...data };
+  }
   async invoke(options) {
     if (!this.allow_internal_execute) {
       throw new SiglumeExperimentalError(
@@ -5975,10 +6206,14 @@ function appendValueChange(changes, emittedKeys, level, key, oldValue, newValue,
 }
 function normalizeManifest(value) {
   const payload = coerceMapping(value, "manifest");
+  const rawDuration = payload.free_trial_duration_days;
+  const duration = rawDuration === void 0 || rawDuration === null ? 30 : Number(rawDuration);
   return {
     ...payload,
     price_model: payload.price_model ?? "free",
     currency: payload.currency ?? "USD",
+    allow_free_trial: Boolean(payload.allow_free_trial ?? false),
+    free_trial_duration_days: Number.isFinite(duration) ? Math.trunc(duration) : 30,
     // AppManifest defaults permission_class to "read-only" (hyphen form,
     // PermissionClass.READ_ONLY). Without this default, a legacy / minimal
     // manifest without permission_class compared against an upgraded one
@@ -6390,6 +6625,12 @@ var ListingCurrency = {
   USD: "USD",
   JPY: "JPY"
 };
+var PersistenceMode = {
+  NONE: "none",
+  LOCAL: "local",
+  PLATFORM: "platform",
+  DEVELOPER_SERVER: "developer_server"
+};
 var ToolManualPermissionClass = {
   READ_ONLY: "read_only",
   ACTION: "action",
@@ -8714,6 +8955,7 @@ export {
   MeterClient,
   OpenAIProvider,
   PermissionClass,
+  PersistenceMode,
   PriceModel,
   RecordMode,
   Recorder,