@idelio/contracts 0.1.0-beta.0

package/dist/credits.d.ts

@@ -0,0 +1,38 @@
+import { z } from "zod";
+export declare const ledgerReasons: readonly ["grant", "purchase", "reserve", "settle", "refund", "clawback"];
+export declare const ledgerEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    workspace_id: z.ZodOptional<z.ZodString>;
+    job_id: z.ZodNullable<z.ZodString>;
+    delta: z.ZodNumber;
+    reason: z.ZodEnum<{
+        grant: "grant";
+        purchase: "purchase";
+        reserve: "reserve";
+        settle: "settle";
+        refund: "refund";
+        clawback: "clawback";
+    }>;
+    idempotency_key: z.ZodOptional<z.ZodString>;
+    balance_after: z.ZodNumber;
+    created_at: z.ZodString;
+}, z.core.$strip>;
+export declare const creditBalanceSchema: z.ZodObject<{
+    balance: z.ZodNumber;
+    plan: z.ZodEnum<{
+        studio: "studio";
+        free: "free";
+        pro: "pro";
+        agency: "agency";
+    }>;
+    monthly_allowance: z.ZodNumber;
+    renews_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const planAllowances: {
+    readonly free: 25;
+    readonly pro: 250;
+    readonly studio: 750;
+    readonly agency: 1400;
+};
+export type LedgerEntry = z.infer<typeof ledgerEntrySchema>;
+export type CreditBalance = z.infer<typeof creditBalanceSchema>;

package/dist/credits.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+export const ledgerReasons = [
+    "grant",
+    "purchase",
+    "reserve",
+    "settle",
+    "refund",
+    "clawback",
+];
+export const ledgerEntrySchema = z.object({
+    id: z.string(),
+    workspace_id: z.string().optional(),
+    job_id: z.string().nullable(),
+    delta: z.number().int(),
+    reason: z.enum(ledgerReasons),
+    idempotency_key: z.string().optional(),
+    balance_after: z.number().int(),
+    created_at: z.string().datetime(),
+});
+export const creditBalanceSchema = z.object({
+    balance: z.number().int(),
+    plan: z.enum(["free", "pro", "studio", "agency"]),
+    monthly_allowance: z.number().int(),
+    renews_at: z.string().datetime().nullable(),
+});
+export const planAllowances = {
+    free: 25,
+    pro: 250,
+    studio: 750,
+    agency: 1400,
+};

package/dist/errors.d.ts

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export declare const errorTypes: readonly ["invalid_request_error", "authentication_error", "permission_error", "not_found_error", "conflict_error", "payment_error", "rate_limit_error", "api_error"];
+export declare const errorEnvelopeSchema: z.ZodObject<{
+    error: z.ZodObject<{
+        type: z.ZodEnum<{
+            invalid_request_error: "invalid_request_error";
+            authentication_error: "authentication_error";
+            permission_error: "permission_error";
+            not_found_error: "not_found_error";
+            conflict_error: "conflict_error";
+            payment_error: "payment_error";
+            rate_limit_error: "rate_limit_error";
+            api_error: "api_error";
+        }>;
+        code: z.ZodString;
+        message: z.ZodString;
+        param: z.ZodOptional<z.ZodString>;
+        request_id: z.ZodString;
+        docs_url: z.ZodOptional<z.ZodString>;
+        errors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            param: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ErrorEnvelope = z.infer<typeof errorEnvelopeSchema>;

package/dist/errors.js

@@ -0,0 +1,22 @@
+import { z } from "zod";
+export const errorTypes = [
+    "invalid_request_error",
+    "authentication_error",
+    "permission_error",
+    "not_found_error",
+    "conflict_error",
+    "payment_error",
+    "rate_limit_error",
+    "api_error",
+];
+export const errorEnvelopeSchema = z.object({
+    error: z.object({
+        type: z.enum(errorTypes),
+        code: z.string(),
+        message: z.string(),
+        param: z.string().optional(),
+        request_id: z.string(),
+        docs_url: z.string().url().optional(),
+        errors: z.array(z.object({ param: z.string(), message: z.string() })).optional(),
+    }),
+});

package/dist/events.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export declare const webhookEventTypes: readonly ["brand.completed", "brand.updated", "asset.ready", "asset.regenerated", "job.failed", "credits.low", "credits.settled", "subscription.changed"];
+export declare const webhookEnvelopeSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        "brand.completed": "brand.completed";
+        "brand.updated": "brand.updated";
+        "asset.ready": "asset.ready";
+        "asset.regenerated": "asset.regenerated";
+        "job.failed": "job.failed";
+        "credits.low": "credits.low";
+        "credits.settled": "credits.settled";
+        "subscription.changed": "subscription.changed";
+    }>;
+    created_at: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const sseEventTypes: readonly ["job.step.started", "job.step.completed", "asset.ready", "asset.failed", "asset.insufficient_credits", "asset.retrying", "assets.pending_retry", "job.completed", "job.completed_with_errors", "job.failed"];
+export type WebhookEventType = (typeof webhookEventTypes)[number];
+export type SseEventType = (typeof sseEventTypes)[number];

package/dist/events.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+export const webhookEventTypes = [
+    "brand.completed",
+    "brand.updated",
+    "asset.ready",
+    "asset.regenerated",
+    "job.failed",
+    "credits.low",
+    "credits.settled",
+    "subscription.changed",
+];
+export const webhookEnvelopeSchema = z.object({
+    id: z.string(),
+    type: z.enum(webhookEventTypes),
+    created_at: z.string().datetime(),
+    data: z.record(z.string(), z.unknown()),
+});
+export const sseEventTypes = [
+    "job.step.started",
+    "job.step.completed",
+    "asset.ready",
+    "asset.failed",
+    "asset.insufficient_credits",
+    "asset.retrying",
+    "assets.pending_retry",
+    "job.completed",
+    "job.completed_with_errors",
+    "job.failed",
+];

package/dist/ids.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+export declare const idPrefixes: {
+    readonly workspace: "ws";
+    readonly user: "user";
+    readonly brand: "brand";
+    readonly brandVersion: "bv";
+    readonly asset: "asset";
+    readonly assetVersion: "av";
+    readonly job: "job";
+    readonly apiKey: "key";
+    readonly creditLedgerEntry: "led";
+    readonly webhookEndpoint: "whe";
+    readonly webhookDelivery: "whd";
+    readonly event: "evt";
+    readonly usageEvent: "evtu";
+    readonly notification: "ntf";
+    readonly waitlistSignup: "wl";
+    readonly designToken: "dt";
+    readonly template: "tpl";
+    readonly consentRecord: "consent";
+    readonly brandSuggestionBatch: "sug";
+    readonly billingIdempotencyKey: "bik";
+    readonly checkoutSession: "chk";
+    readonly jobAsset: "asset_job";
+    readonly request: "req";
+};
+export type IdPrefix = (typeof idPrefixes)[keyof typeof idPrefixes];
+export declare const prefixedId: (prefix: IdPrefix) => z.ZodString;

package/dist/ids.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+export const idPrefixes = {
+    workspace: "ws",
+    user: "user",
+    brand: "brand",
+    brandVersion: "bv",
+    asset: "asset",
+    assetVersion: "av",
+    job: "job",
+    apiKey: "key",
+    creditLedgerEntry: "led",
+    webhookEndpoint: "whe",
+    webhookDelivery: "whd",
+    event: "evt",
+    usageEvent: "evtu",
+    notification: "ntf",
+    waitlistSignup: "wl",
+    designToken: "dt",
+    template: "tpl",
+    consentRecord: "consent",
+    brandSuggestionBatch: "sug",
+    billingIdempotencyKey: "bik",
+    checkoutSession: "chk",
+    jobAsset: "asset_job",
+    request: "req",
+};
+export const prefixedId = (prefix) => z.string().regex(new RegExp(`^${prefix}_[a-zA-Z0-9]{8,}$`), {
+    message: `expected an id prefixed with "${prefix}_"`,
+});

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export * from "./api-keys.js";
+export * from "./assets.js";
+export * from "./billing.js";
+export * from "./brands.js";
+export * from "./catalog.js";
+export * from "./consent.js";
+export * from "./creative-direction.js";
+export * from "./credits.js";
+export * from "./errors.js";
+export * from "./events.js";
+export * from "./ids.js";
+export * from "./jobs.js";
+export * from "./me.js";
+export * from "./notifications.js";
+export * from "./pricing.js";
+export * from "./rate-limits.js";
+export * from "./usage.js";
+export * from "./waitlist.js";
+export * from "./webhooks.js";

package/dist/index.js

@@ -0,0 +1,19 @@
+export * from "./api-keys.js";
+export * from "./assets.js";
+export * from "./billing.js";
+export * from "./brands.js";
+export * from "./catalog.js";
+export * from "./consent.js";
+export * from "./creative-direction.js";
+export * from "./credits.js";
+export * from "./errors.js";
+export * from "./events.js";
+export * from "./ids.js";
+export * from "./jobs.js";
+export * from "./me.js";
+export * from "./notifications.js";
+export * from "./pricing.js";
+export * from "./rate-limits.js";
+export * from "./usage.js";
+export * from "./waitlist.js";
+export * from "./webhooks.js";

package/dist/jobs.d.ts

@@ -0,0 +1,100 @@
+import { z } from "zod";
+export declare const jobStatuses: readonly ["queued", "running", "completed", "completed_with_errors", "failed", "canceled"];
+export declare const pipelineSteps: readonly ["intake", "strategy", "visual_system", "logo", "brand_guardian", "applications", "render_package", "persist_deliver"];
+export declare const jobStepNames: readonly ["intake", "strategy", "visual_system", "logo", "brand_guardian", "applications", "render_package", "persist_deliver", ...("logo_alternative" | "logo_wordmark" | "color_palette" | "font_pairing" | "logo_mono" | "logo_reversed" | "favicon" | "brand_guide" | "profile_avatar" | "social_x" | "social_linkedin" | "social_linkedin_personal" | "social_facebook" | "social_youtube" | "social_post" | "social_story" | "app_icon" | "og_image" | "email_signature" | "hero_image" | "play_feature_graphic" | "business_card" | "letterhead" | "mockup" | "custom_image")[], "packaging", "dna_refine"];
+export declare const jobStepSchema: z.ZodObject<{
+    step: z.ZodString;
+    status: z.ZodEnum<{
+        failed: "failed";
+        pending: "pending";
+        running: "running";
+        completed: "completed";
+        skipped: "skipped";
+    }>;
+    started_at: z.ZodNullable<z.ZodString>;
+    completed_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const jobKinds: readonly ["brand_generation", "asset_regeneration", "brand_expand", "brand_export", "brand_bundle", "brand_dna_refine"];
+export type JobKind = (typeof jobKinds)[number];
+export declare const generationJobSchema: z.ZodObject<{
+    id: z.ZodString;
+    brand_id: z.ZodString;
+    kind: z.ZodEnum<{
+        brand_generation: "brand_generation";
+        asset_regeneration: "asset_regeneration";
+        brand_expand: "brand_expand";
+        brand_export: "brand_export";
+        brand_bundle: "brand_bundle";
+        brand_dna_refine: "brand_dna_refine";
+    }>;
+    workflow_id: z.ZodString;
+    team_tier: z.ZodEnum<{
+        flash: "flash";
+        studio: "studio";
+        elite: "elite";
+    }>;
+    credit_multiplier: z.ZodNumber;
+    status: z.ZodEnum<{
+        failed: "failed";
+        queued: "queued";
+        running: "running";
+        completed: "completed";
+        completed_with_errors: "completed_with_errors";
+        canceled: "canceled";
+    }>;
+    steps: z.ZodArray<z.ZodObject<{
+        step: z.ZodString;
+        status: z.ZodEnum<{
+            failed: "failed";
+            pending: "pending";
+            running: "running";
+            completed: "completed";
+            skipped: "skipped";
+        }>;
+        started_at: z.ZodNullable<z.ZodString>;
+        completed_at: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    credits_reserved: z.ZodNumber;
+    credits_used: z.ZodNullable<z.ZodNumber>;
+    eta_seconds: z.ZodNullable<z.ZodNumber>;
+    download_url: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodString;
+}, z.core.$strip>;
+export type GenerationJob = z.infer<typeof generationJobSchema>;
+export type PipelineStep = (typeof pipelineSteps)[number];
+export type JobStepName = (typeof jobStepNames)[number];
+export declare const logoLockupOverrideSchema: z.ZodEnum<{
+    horizontal: "horizontal";
+    stacked: "stacked";
+}>;
+export declare const logoSelectionRequestSchema: z.ZodObject<{
+    asset_version_id: z.ZodString;
+    lockup_override: z.ZodOptional<z.ZodEnum<{
+        horizontal: "horizontal";
+        stacked: "stacked";
+    }>>;
+    family_override: z.ZodOptional<z.ZodString>;
+    ink_override: z.ZodOptional<z.ZodString>;
+    accent_override: z.ZodOptional<z.ZodString>;
+    style_seed_override: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type LogoSelectionRequest = z.infer<typeof logoSelectionRequestSchema>;
+export declare const logoConceptPreviewQuerySchema: z.ZodObject<{
+    lockup: z.ZodOptional<z.ZodEnum<{
+        horizontal: "horizontal";
+        stacked: "stacked";
+    }>>;
+    family: z.ZodOptional<z.ZodString>;
+    ink: z.ZodOptional<z.ZodString>;
+    accent: z.ZodOptional<z.ZodString>;
+    style_seed: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type LogoConceptPreviewQuery = z.infer<typeof logoConceptPreviewQuerySchema>;
+export declare const logoConceptPaletteSchema: z.ZodObject<{
+    tokens: z.ZodArray<z.ZodObject<{
+        hex: z.ZodString;
+        role: z.ZodString;
+    }, z.core.$strip>>;
+    brand_name: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type LogoConceptPalette = z.infer<typeof logoConceptPaletteSchema>;

package/dist/jobs.js

@@ -0,0 +1,81 @@
+import { z } from "zod";
+import { expandableAssetKinds, teamTiers } from "./brands.js";
+export const jobStatuses = [
+    "queued",
+    "running",
+    "completed",
+    "completed_with_errors",
+    "failed",
+    "canceled",
+];
+export const pipelineSteps = [
+    "intake",
+    "strategy",
+    "visual_system",
+    "logo",
+    "brand_guardian",
+    "applications",
+    "render_package",
+    "persist_deliver",
+];
+export const jobStepNames = [
+    ...pipelineSteps,
+    ...expandableAssetKinds,
+    "packaging",
+    "dna_refine",
+];
+export const jobStepSchema = z.object({
+    step: z.string().min(1),
+    status: z.enum(["pending", "running", "completed", "failed", "skipped"]),
+    started_at: z.string().datetime().nullable(),
+    completed_at: z.string().datetime().nullable(),
+});
+export const jobKinds = [
+    "brand_generation",
+    "asset_regeneration",
+    "brand_expand",
+    "brand_export",
+    "brand_bundle",
+    "brand_dna_refine",
+];
+export const generationJobSchema = z.object({
+    id: z.string(),
+    brand_id: z.string(),
+    kind: z.enum(jobKinds),
+    workflow_id: z.string(),
+    team_tier: z.enum(teamTiers),
+    credit_multiplier: z.number(),
+    status: z.enum(jobStatuses),
+    steps: z.array(jobStepSchema),
+    credits_reserved: z.number().int(),
+    credits_used: z.number().int().nullable(),
+    eta_seconds: z.number().int().nullable(),
+    download_url: z.string().nullable(),
+    created_at: z.string().datetime(),
+});
+export const logoLockupOverrideSchema = z.enum(["horizontal", "stacked"]);
+const hexColorSchema = z
+    .string()
+    .regex(/^#[0-9A-Fa-f]{6}$/, "must be a 6-digit hex colour like #14162E");
+export const logoSelectionRequestSchema = z.object({
+    asset_version_id: z.string(),
+    lockup_override: logoLockupOverrideSchema.optional(),
+    family_override: z.string().optional(),
+    ink_override: hexColorSchema.optional(),
+    accent_override: hexColorSchema.optional(),
+    style_seed_override: z.string().optional(),
+});
+export const logoConceptPreviewQuerySchema = z.object({
+    lockup: logoLockupOverrideSchema.optional(),
+    family: z.string().optional(),
+    ink: hexColorSchema.optional(),
+    accent: hexColorSchema.optional(),
+    style_seed: z.string().optional(),
+});
+export const logoConceptPaletteSchema = z.object({
+    tokens: z.array(z.object({
+        hex: z.string(),
+        role: z.string(),
+    })),
+    brand_name: z.string().nullable(),
+});

package/dist/me.d.ts

@@ -0,0 +1,77 @@
+import { z } from "zod";
+export declare const workspaceRoles: readonly ["owner", "admin", "member"];
+export declare const workspaceRoleSchema: z.ZodEnum<{
+    owner: "owner";
+    admin: "admin";
+    member: "member";
+}>;
+export type WorkspaceRole = z.infer<typeof workspaceRoleSchema>;
+export declare const meResponseSchema: z.ZodObject<{
+    user: z.ZodObject<{
+        id: z.ZodString;
+        email: z.ZodNullable<z.ZodString>;
+        clerkUserId: z.ZodNullable<z.ZodString>;
+        termsAcceptedAt: z.ZodNullable<z.ZodString>;
+        onboardingCompletedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
+    workspace: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        clerkOrgId: z.ZodString;
+        plan: z.ZodString;
+    }, z.core.$strip>;
+    role: z.ZodEnum<{
+        owner: "owner";
+        admin: "admin";
+        member: "member";
+    }>;
+}, z.core.$strip>;
+export type MeResponse = z.infer<typeof meResponseSchema>;
+export declare const completeOnboardingResponseSchema: z.ZodObject<{
+    onboardingCompletedAt: z.ZodString;
+}, z.core.$strip>;
+export type CompleteOnboardingResponse = z.infer<typeof completeOnboardingResponseSchema>;
+export declare const workspaceSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    plan: z.ZodEnum<{
+        studio: "studio";
+        free: "free";
+        pro: "pro";
+        agency: "agency";
+    }>;
+    settings: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export type Workspace = z.infer<typeof workspaceSchema>;
+export declare const updateWorkspaceRequestSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type UpdateWorkspaceRequest = z.infer<typeof updateWorkspaceRequestSchema>;
+export declare const memberSchema: z.ZodObject<{
+    id: z.ZodString;
+    email: z.ZodString;
+    role: z.ZodEnum<{
+        owner: "owner";
+        admin: "admin";
+        member: "member";
+    }>;
+    created_at: z.ZodString;
+}, z.core.$strip>;
+export type Member = z.infer<typeof memberSchema>;
+export declare const inviteMemberRequestSchema: z.ZodObject<{
+    email: z.ZodString;
+    role: z.ZodEnum<{
+        admin: "admin";
+        member: "member";
+    }>;
+}, z.core.$strip>;
+export type InviteMemberRequest = z.infer<typeof inviteMemberRequestSchema>;
+export declare const changeMemberRoleRequestSchema: z.ZodObject<{
+    role: z.ZodEnum<{
+        owner: "owner";
+        admin: "admin";
+        member: "member";
+    }>;
+}, z.core.$strip>;
+export type ChangeMemberRoleRequest = z.infer<typeof changeMemberRoleRequestSchema>;

package/dist/me.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+export const workspaceRoles = ["owner", "admin", "member"];
+export const workspaceRoleSchema = z.enum(workspaceRoles);
+export const meResponseSchema = z.object({
+    user: z.object({
+        id: z.string(),
+        email: z.string().email().nullable(),
+        clerkUserId: z.string().nullable(),
+        termsAcceptedAt: z.string().datetime().nullable(),
+        onboardingCompletedAt: z.string().datetime().nullable().optional(),
+    }),
+    workspace: z.object({
+        id: z.string(),
+        name: z.string(),
+        clerkOrgId: z.string(),
+        plan: z.string(),
+    }),
+    role: workspaceRoleSchema,
+});
+export const completeOnboardingResponseSchema = z.object({
+    onboardingCompletedAt: z.string().datetime(),
+});
+export const workspaceSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    plan: z.enum(["free", "pro", "studio", "agency"]),
+    settings: z.record(z.string(), z.unknown()),
+});
+export const updateWorkspaceRequestSchema = z.object({
+    name: z.string().min(1).optional(),
+    settings: z.record(z.string(), z.unknown()).optional(),
+});
+export const memberSchema = z.object({
+    id: z.string(),
+    email: z.string().email(),
+    role: workspaceRoleSchema,
+    created_at: z.string().datetime(),
+});
+export const inviteMemberRequestSchema = z.object({
+    email: z.string().email(),
+    role: z.enum(["admin", "member"]),
+});
+export const changeMemberRoleRequestSchema = z.object({
+    role: workspaceRoleSchema,
+});

package/dist/notifications.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+export declare const notificationEventKeys: readonly ["workspace_welcome", "member_joined", "low_credits", "payment_failed", "trial_ending", "brand_ready", "asset_ready", "logo_pending", "generation_failed", "purchase_confirmed"];
+export type NotificationEventKey = (typeof notificationEventKeys)[number];
+export declare const notificationDataSchema: z.ZodObject<{
+    brand_id: z.ZodOptional<z.ZodString>;
+    brand_name: z.ZodOptional<z.ZodString>;
+    job_id: z.ZodOptional<z.ZodString>;
+    asset_id: z.ZodOptional<z.ZodString>;
+    asset_kind: z.ZodOptional<z.ZodString>;
+    balance: z.ZodOptional<z.ZodNumber>;
+    next_retry_at: z.ZodOptional<z.ZodString>;
+    refunded: z.ZodOptional<z.ZodBoolean>;
+    canceled: z.ZodOptional<z.ZodBoolean>;
+    checkout_session_id: z.ZodOptional<z.ZodString>;
+    purchased_credits: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type NotificationData = z.infer<typeof notificationDataSchema>;

package/dist/notifications.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export const notificationEventKeys = [
+    "workspace_welcome",
+    "member_joined",
+    "low_credits",
+    "payment_failed",
+    "trial_ending",
+    "brand_ready",
+    "asset_ready",
+    "logo_pending",
+    "generation_failed",
+    "purchase_confirmed",
+];
+export const notificationDataSchema = z.object({
+    brand_id: z.string().optional(),
+    brand_name: z.string().optional(),
+    job_id: z.string().optional(),
+    asset_id: z.string().optional(),
+    asset_kind: z.string().optional(),
+    balance: z.number().optional(),
+    next_retry_at: z.string().optional(),
+    refunded: z.boolean().optional(),
+    canceled: z.boolean().optional(),
+    checkout_session_id: z.string().optional(),
+    purchased_credits: z.number().optional(),
+});

package/dist/pricing.d.ts

@@ -0,0 +1,38 @@
+import type { AssetKind, TeamTier } from "./brands.js";
+export declare const ASSET_BASE_CREDITS: Record<AssetKind, number>;
+export declare const CREDIT_MULTIPLIERS: Record<TeamTier, number>;
+export declare const FREE_KINDS: ReadonlySet<string>;
+export declare const LOW_CREDITS_THRESHOLD = 25;
+export declare const FREE_PLAN_CREDITS = 25;
+export declare const DNA_REFINE_CREDITS = 3;
+export declare const LOGO_CONCEPT_REGENERATE_CREDITS = 2;
+export declare function estimateCredits(assets: readonly AssetKind[], tier: TeamTier): number;
+export declare function creditsForKind(kind: string): number | null;
+export interface Plan {
+    id: "free" | "pro" | "studio" | "agency";
+    name: string;
+    priceUsd: number;
+    credits: number;
+    popular?: boolean;
+    features: readonly string[];
+}
+export declare const PLANS: readonly Plan[];
+export interface CreditPack {
+    credits: number;
+    priceUsd: number;
+    perCreditUsd: number;
+    badge?: "MOST POPULAR" | "BEST VALUE";
+}
+export declare const CREDIT_PACKS: readonly CreditPack[];
+export declare const TAX_NOTICE = "Prices exclude tax. Any tax due is shown at checkout.";
+export declare const SELLER_NOTICE = "Sold by SFER LABS LLC. Stripe processes the payment.";
+export declare function renewalNotice(priceUsd: number): string;
+export declare const DEFAULT_AUTO_TOPUP_PACK_CREDITS = 300;
+export declare const AGENCY_RATES: {
+    readonly baseUsd: 3800;
+    readonly perAssetUsd: 520;
+};
+export declare const CALCULATOR: {
+    readonly planCoveredAssets: 24;
+    readonly topUpPerAssetUsd: 1.2;
+};