@feltdb/core 0.7.3 → 0.8.0

package/dist/module-intent.d.ts

@@ -0,0 +1,37 @@
+import type { FeltDBContractSnapshot, FeltDBFlowProposal } from './application-development.js';
+import { type FeltDBModuleDefinition, type FeltDBModuleOwnership } from './module.js';
+export interface ModuleIntent {
+    action: 'implement' | 'extend';
+    module: string;
+    provider: string;
+    version: string;
+    original: string;
+}
+export interface ModuleImplementationPlan {
+    intent: ModuleIntent;
+    module: FeltDBModuleDefinition;
+    alreadyInstalled: boolean;
+    owner: string;
+    applicationModels: Array<{
+        name: string;
+        ownership: FeltDBModuleOwnership;
+        purpose: string;
+    }>;
+    relationships: string[];
+    events: string[];
+    workflows: string[];
+    capabilities: string[];
+    authorization: FeltDBModuleDefinition['authorization'];
+    configuration: string[];
+    secrets: string[];
+    stateFlow: string[];
+    warnings: string[];
+}
+export declare function resolveModuleIntent(value: string): ModuleIntent | undefined;
+export declare function planModuleImplementation(intent: ModuleIntent, snapshot: FeltDBContractSnapshot, currentFlow: string): ModuleImplementationPlan;
+export declare function createModuleImplementationProposal(input: {
+    intent: string;
+    snapshot: FeltDBContractSnapshot;
+    currentFlow: string;
+}): Promise<FeltDBFlowProposal>;
+//# sourceMappingURL=module-intent.d.ts.map

package/dist/module-intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-intent.d.ts","sourceRoot":"","sources":["../src/module-intent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAE/F,OAAO,EAA6D,KAAK,sBAAsB,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEjJ,MAAM,WAAW,YAAY;IAAG,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AACrI,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAC/F,iBAAiB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,qBAAqB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9F,aAAa,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvF,aAAa,EAAE,sBAAsB,CAAC,eAAe,CAAC,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IACnG,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACzC;AAMD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAU3E;AAQD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,GAAG,wBAAwB,CAgB9I;AAGD,wBAAsB,kCAAkC,CAAC,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,sBAAsB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAuBtK"}

package/dist/module-intent.js

@@ -0,0 +1,81 @@
+import { formatFlowSpec, parseFlowSpec } from './flowspec.js';
+import { findFeltDBModules, listFeltDBModules, resolveFeltDBModule } from './module.js';
+async function sourceHash(source) {
+    const digest = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(source.replace(/\r\n/g, '\n')));
+    return `sha256:${Array.from(new Uint8Array(digest), byte => byte.toString(16).padStart(2, '0')).join('')}`;
+}
+export function resolveModuleIntent(value) {
+    const match = /^\s*implement\s+([a-z0-9][a-z0-9-]*)\s*[.!]?\s*$/i.exec(value);
+    const incrementalBilling = /^\s*(?:add|support|enable)\b.+\b(?:billing|plan|subscription)\b.*$/i.test(value);
+    if (!match && !incrementalBilling)
+        return undefined;
+    const requested = match ? match[1].toLowerCase() : 'billing';
+    const matches = findFeltDBModules(requested);
+    if (!matches.length)
+        throw new Error(`MODULE_NOT_AVAILABLE: ${requested}. No proposal created. Available modules: ${listFeltDBModules().map(module => module.id).join(', ')}`);
+    if (matches.length > 1)
+        throw new Error(`AMBIGUOUS_MODULE_INTENT: ${requested}. Available providers: ${matches.map(module => module.provider).join(', ')}`);
+    const module = matches[0];
+    return { action: match ? 'implement' : 'extend', module: module.id, provider: module.provider, version: module.version, original: value };
+}
+function billingOwner(spec, module) {
+    const names = new Set(spec.collections.map(collection => collection.name));
+    for (const pattern of module.patterns)
+        for (const candidate of pattern.owner_candidates)
+            if (names.has(candidate))
+                return candidate;
+    return spec.collections.find(collection => /user|account|member/i.test(collection.name))?.name ?? spec.collections[0]?.name ?? 'User';
+}
+export function planModuleImplementation(intent, snapshot, currentFlow) {
+    const module = resolveFeltDBModule({ name: intent.module, provider: intent.provider, version: intent.version });
+    const spec = parseFlowSpec(currentFlow);
+    const owner = billingOwner(spec, module);
+    const alreadyInstalled = Boolean(spec.modules?.some(value => value.name === module.id));
+    const pattern = module.patterns.find(value => value.owner_candidates.includes(owner)) ?? module.patterns[0];
+    const implementedEvents = new Set(spec.triggers.map(value => value.event));
+    const implementedWorkflows = new Set(spec.workflows.map(value => value.name));
+    return { intent, module, alreadyInstalled, owner, applicationModels: pattern.application_models,
+        relationships: [`BillingAccount.owner -> ${owner}`, `BillingAccount.customer -> ${module.id}.Customer`, `BillingAccount.subscription -> ${module.id}.Subscription`, `Entitlement.billing_account -> BillingAccount`],
+        events: module.reconciliation.map(value => value.event).filter(value => !implementedEvents.has(value)),
+        workflows: module.reconciliation.map(value => value.workflow).filter(value => !implementedWorkflows.has(value)),
+        capabilities: ['stripe.checkout.create', 'stripe.subscription.read', 'stripe.subscription.cancel'].filter(value => module.capabilities.includes(value)),
+        authorization: module.authorization, configuration: module.configuration.map(value => value.name), secrets: module.secrets.map(value => value.name),
+        stateFlow: [`${module.id}.subscription.updated`, `ReconcileSubscription`, `BillingAccount`, `Entitlement`],
+        warnings: ['Production webhook configuration and signature verification required'],
+    };
+}
+function addCollection(spec, collection) { if (!spec.collections.some(value => value.name === collection.name))
+    spec.collections.push(collection); }
+export async function createModuleImplementationProposal(input) {
+    const resolved = resolveModuleIntent(input.intent);
+    if (!resolved)
+        throw new Error('NOT_A_MODULE_INTENT');
+    const plan = planModuleImplementation(resolved, input.snapshot, input.currentFlow);
+    const spec = parseFlowSpec(input.currentFlow);
+    if (resolved.action === 'extend' && !plan.alreadyInstalled)
+        throw new Error(`MODULE_NOT_INSTALLED: ${plan.module.id}. Run implement ${plan.module.id} first.`);
+    if (!spec.modules?.some(value => value.name === plan.module.id))
+        spec.modules.push({ name: plan.module.id, provider: plan.module.provider, version: plan.module.version });
+    addCollection(spec, { name: 'BillingAccount', fields: [
+            { name: 'owner', type: `ref ${plan.owner}`, optional: false }, { name: 'customer', type: `ref ${plan.module.id}.Customer`, optional: false },
+            { name: 'subscription', type: `ref ${plan.module.id}.Subscription`, optional: true }, { name: 'status', type: 'text', optional: false },
+        ], indexes: [] });
+    addCollection(spec, { name: 'Entitlement', fields: [{ name: 'billing_account', type: 'ref BillingAccount', optional: false }, { name: 'key', type: 'text', optional: false }, { name: 'active', type: 'boolean', optional: false }], indexes: [] });
+    if (resolved.action === 'extend')
+        addCollection(spec, { name: 'BillingPlan', fields: [
+                { name: 'code', type: 'text', optional: false }, { name: 'interval', type: 'enum(monthly,annual)', optional: false },
+                { name: 'price', type: `ref ${plan.module.id}.Price`, optional: false }, { name: 'active', type: 'boolean', optional: false },
+            ], indexes: [] });
+    for (const reconciliation of plan.module.reconciliation) {
+        if (!spec.workflows.some(value => value.name === reconciliation.workflow))
+            spec.workflows.push({ name: reconciliation.workflow, parameters: '', steps: [{ name: 'reconcile', statements: ['read BillingAccount', 'write BillingAccount', 'write Entitlement', `capability ${plan.module.id}.subscription.read`] }] });
+        if (!spec.triggers.some(value => value.event === reconciliation.event))
+            spec.triggers.push({ event: reconciliation.event, statements: [`run ${reconciliation.workflow}`] });
+    }
+    if (!spec.policies.some(value => value.name === 'BillingAccount'))
+        spec.policies.push({ name: 'BillingAccount', statements: ['read: owner', 'write: owner'] });
+    const prefix = resolved.action === 'extend' ? 'Extend' : plan.alreadyInstalled ? 'Complete' : 'Implement';
+    return { baseContractHash: input.snapshot.contract_hash, baseFlowHash: await sourceHash(input.currentFlow), proposedFlow: formatFlowSpec(spec),
+        summary: `${prefix} ${plan.module.name}`, changes: [...(resolved.action === 'extend' ? ['BillingPlan (application-authoritative)', 'BillingPlan.price -> stripe.Price'] : plan.applicationModels.map(value => `${value.name} (${value.ownership})`)), ...plan.relationships, ...plan.workflows, ...plan.capabilities],
+        warnings: [...plan.warnings, ...(resolved.action === 'extend' ? ['Plan and price records must be configured through application data; no provider values were invented'] : [])], implementation: plan };
+}

package/dist/module.d.ts

@@ -0,0 +1,76 @@
+export type FeltDBModuleOwnership = 'external-authoritative' | 'application-authoritative' | 'derived' | 'synchronized';
+export interface FeltDBModuleModel {
+    name: string;
+    authority: 'external';
+    ownership: FeltDBModuleOwnership;
+    fields: {
+        name: string;
+        type: string;
+        optional?: boolean;
+        immutable?: boolean;
+        externally_owned?: boolean;
+        application_readable?: boolean;
+    }[];
+}
+export interface FeltDBModuleRelationship {
+    from: string;
+    to: string;
+    kind: 'one' | 'many';
+}
+export interface FeltDBModuleRequirement {
+    name: string;
+    required: boolean;
+    environments?: string[];
+    description: string;
+}
+export interface FeltDBModulePattern {
+    name: string;
+    when: string;
+    owner_candidates: string[];
+    application_models: Array<{
+        name: string;
+        ownership: FeltDBModuleOwnership;
+        purpose: string;
+    }>;
+}
+export interface FeltDBModuleReconciliation {
+    event: string;
+    workflow: string;
+    reads: string[];
+    writes: string[];
+    outcome: string;
+}
+export interface FeltDBModuleDefinition {
+    id: string;
+    name: string;
+    version: string;
+    provider: string;
+    compatibility: string[];
+    models: FeltDBModuleModel[];
+    relationships: FeltDBModuleRelationship[];
+    events: string[];
+    capabilities: string[];
+    workflows: string[];
+    configuration: FeltDBModuleRequirement[];
+    secrets: FeltDBModuleRequirement[];
+    validation: string[];
+    dependencies: string[];
+    authorization: Array<{
+        capability: string;
+        subject: string;
+        implication: string;
+    }>;
+    patterns: FeltDBModulePattern[];
+    reconciliation: FeltDBModuleReconciliation[];
+}
+export interface FlowModuleDeclaration {
+    name: string;
+    provider: string;
+    version?: string;
+}
+export declare function listFeltDBModules(): FeltDBModuleDefinition[];
+export declare function resolveFeltDBModule(declaration: FlowModuleDeclaration): FeltDBModuleDefinition;
+export declare function findFeltDBModules(query: string): FeltDBModuleDefinition[];
+export declare function resolveFeltDBModules(declarations?: FlowModuleDeclaration[]): FeltDBModuleDefinition[];
+export declare function validateResolvedModules(modules: FeltDBModuleDefinition[], environment?: string): string[];
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"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"}

package/dist/module.js

@@ -0,0 +1,61 @@
+const stripe = {
+    id: 'stripe', name: 'Stripe-compatible billing', version: '1.0.0', provider: 'stripe-compatible',
+    compatibility: ['stripe', 'stripe-compatible'],
+    models: ['Customer', 'Product', 'Price', 'Subscription', 'SubscriptionItem', 'Invoice', 'PaymentIntent', 'CheckoutSession', 'PaymentMethod', 'Refund', 'WebhookEvent']
+        .map(name => ({ name, authority: 'external', ownership: 'external-authoritative', fields: [
+            { name: 'id', type: 'text', immutable: true, externally_owned: true, application_readable: true },
+            { name: 'status', type: 'text', optional: true, externally_owned: true, application_readable: true },
+            { name: 'created_at', type: 'datetime', externally_owned: true, application_readable: true },
+            { name: 'metadata', type: 'json', optional: true, externally_owned: true, application_readable: true },
+        ] })),
+    relationships: [
+        { from: 'Customer', to: 'Subscription', kind: 'many' }, { from: 'Subscription', to: 'SubscriptionItem', kind: 'many' },
+        { from: 'SubscriptionItem', to: 'Price', kind: 'one' }, { from: 'Price', to: 'Product', kind: 'one' },
+        { from: 'Customer', to: 'Invoice', kind: 'many' }, { from: 'Invoice', to: 'PaymentIntent', kind: 'one' },
+    ],
+    events: ['stripe.customer.created', 'stripe.customer.updated', 'stripe.subscription.created', 'stripe.subscription.updated', 'stripe.subscription.deleted', 'stripe.invoice.paid', 'stripe.invoice.payment_failed', 'stripe.checkout.session.completed'],
+    capabilities: ['stripe.customer.read', 'stripe.customer.create', 'stripe.checkout.create', 'stripe.subscription.read', 'stripe.subscription.create', 'stripe.subscription.cancel', 'stripe.invoice.read', 'stripe.webhooks.receive'],
+    workflows: ['ReconcileSubscription', 'ReconcileFailedPayment'],
+    configuration: [{ name: 'STRIPE_PUBLISHABLE_KEY', required: false, description: 'Browser-safe publishable provider key' }],
+    secrets: [{ name: 'STRIPE_SECRET_KEY', required: true, description: 'Server-side provider credential' }, { name: 'STRIPE_WEBHOOK_SECRET', required: true, environments: ['production'], description: 'Webhook signature verification secret' }],
+    validation: ['Webhook receivers must verify signatures', 'Checkout creation requires authenticated authorization'],
+    dependencies: [],
+    authorization: [
+        { capability: 'stripe.checkout.create', subject: 'authenticated', implication: 'A signed-in billing owner may create a hosted checkout session' },
+        { capability: 'stripe.subscription.cancel', subject: 'owner', implication: 'Only the billing owner may cancel a subscription' },
+    ],
+    patterns: [
+        { name: 'organization billing', when: 'The application contains Organization or Workspace state', owner_candidates: ['Organization', 'Workspace'], application_models: [
+                { name: 'BillingAccount', ownership: 'application-authoritative', purpose: 'Connect the application billing owner to provider state' },
+                { name: 'Entitlement', ownership: 'derived', purpose: 'Materialize product access from reconciled subscription state' },
+            ] },
+        { name: 'user billing', when: 'The application is user-centric and has no organizational owner', owner_candidates: ['User', 'Account'], application_models: [
+                { name: 'BillingAccount', ownership: 'application-authoritative', purpose: 'Connect the user to provider state' },
+                { name: 'Entitlement', ownership: 'derived', purpose: 'Materialize product access from reconciled subscription state' },
+            ] },
+    ],
+    reconciliation: [
+        { event: 'stripe.subscription.updated', workflow: 'ReconcileSubscription', reads: ['stripe.Subscription', 'BillingAccount'], writes: ['BillingAccount', 'Entitlement'], outcome: 'Subscription changes become application entitlements' },
+        { event: 'stripe.invoice.payment_failed', workflow: 'ReconcileFailedPayment', reads: ['stripe.Invoice', 'BillingAccount'], writes: ['BillingAccount', 'Entitlement'], outcome: 'Failed payment state restricts derived entitlements' },
+    ],
+};
+const definitions = new Map([[stripe.id, stripe]]);
+export function listFeltDBModules() { return [...definitions.values()].map(value => structuredClone(value)); }
+export function resolveFeltDBModule(declaration) {
+    const definition = definitions.get(declaration.name);
+    if (!definition)
+        throw new Error(`UNKNOWN_MODULE: ${declaration.name}`);
+    if (!definition.compatibility.includes(declaration.provider))
+        throw new Error(`INCOMPATIBLE_MODULE_PROVIDER: ${declaration.name} does not support ${declaration.provider}`);
+    if (declaration.version && declaration.version !== definition.version)
+        throw new Error(`INCOMPATIBLE_MODULE_VERSION: ${declaration.name}@${declaration.version}; available ${definition.version}`);
+    return { ...structuredClone(definition), provider: declaration.provider };
+}
+export function findFeltDBModules(query) {
+    const normalized = query.trim().toLowerCase();
+    return listFeltDBModules().filter(module => module.id === normalized || module.name.toLowerCase().includes(normalized) || module.compatibility.some(value => value.includes(normalized)));
+}
+export function resolveFeltDBModules(declarations = []) { return declarations.map(resolveFeltDBModule).sort((a, b) => a.id.localeCompare(b.id)); }
+export function validateResolvedModules(modules, environment = 'development') {
+    return modules.flatMap(module => [...module.secrets.filter(value => value.required && (!value.environments || value.environments.includes(environment))).map(value => `${value.name} is required in ${environment} runtime configuration`), ...module.capabilities.filter(value => value.endsWith('.create')).map(value => `${value} requires an explicit authorization policy`)]);
+}

package/dist/proposal.d.ts

@@ -0,0 +1,161 @@
+import { type FeltDBContractSnapshot } from './application-development.js';
+export declare const FELTDB_PROPOSAL_COLLECTION = "_feltdb.Proposal";
+export declare const FELTDB_PROPOSAL_EVENT_COLLECTION = "_feltdb.ProposalEvent";
+export declare const FELTDB_PROPOSAL_PREVIEW_COLLECTION = "_feltdb.ProposalPreview";
+export declare const FELTDB_PROPOSAL_VERSION = 1;
+export type ProposalStatus = 'proposed' | 'validated' | 'previewed' | 'approved' | 'applied' | 'rejected' | 'expired';
+export interface ProposalSourceOperation {
+    path: string;
+    operation: 'add' | 'modify' | 'delete';
+}
+export interface FeltDBProposalRecord {
+    id: string;
+    application_id: string;
+    environment: string;
+    status: ProposalStatus;
+    proposal_version: 1;
+    base_contract_version: number;
+    base_contract_hash: string;
+    base_flow_hash: string;
+    proposed_flow: string;
+    contract_diff: string[];
+    source_plan: {
+        files: ProposalSourceOperation[];
+    };
+    summary: string;
+    warnings: string[];
+    created_by: string;
+    created_at: string | number;
+    approved_by?: string;
+    approved_at?: string | number;
+    applied_at?: string | number;
+    preview_id?: string;
+    expires_at?: string | number;
+    metadata: Record<string, string>;
+    parent_proposal_id?: string;
+    module_versions: {
+        id: string;
+        provider: string;
+        version: string;
+    }[];
+    base_module_versions?: {
+        id: string;
+        provider: string;
+        version: string;
+    }[];
+    module_impact: {
+        modules: string[];
+        models: string[];
+        relationships: string[];
+        events: string[];
+        workflows: string[];
+        capabilities: string[];
+        authorization: string[];
+        configuration: string[];
+        secrets: string[];
+        ownership: Record<string, string>;
+        state_flow: string[];
+    };
+}
+export interface FeltDBProposalEvent {
+    id: string;
+    proposal_id: string;
+    from_status?: ProposalStatus;
+    to_status: ProposalStatus;
+    actor: string;
+    created_at: string | number;
+    metadata: Record<string, string>;
+}
+export interface ProposalReadiness {
+    status: ProposalStatus;
+    readiness: 'ready' | 'blocked';
+    blockers: ('contract_changed' | 'flow_changed' | 'module_versions_changed' | 'expired')[];
+    notes: string[];
+    current_contract_hash: string;
+    proposal_contract_hash: string;
+    current_flow_hash: string;
+    proposal_flow_hash: string;
+    stale: boolean;
+    expires_at?: string | number;
+}
+export interface FeltDBProposalPreviewArtifact {
+    preview_id: string;
+    proposal_id: string;
+    application_id: string;
+    environment: string;
+    proposal_hash: string;
+    created_at: string;
+    expires_at: string;
+    status: 'ready';
+    current: FeltDBContractSnapshot;
+    proposed: FeltDBContractSnapshot;
+    current_contract: FeltDBContractSnapshot;
+    proposed_contract: FeltDBContractSnapshot;
+    semantic_diff: string[];
+    state_flow: string[];
+    capabilities: unknown[];
+    workflows: unknown[];
+    authorization: unknown[];
+    configuration: string[];
+    secrets: string[];
+    modules: string[];
+    ownership: Record<string, string>;
+    relationships: string[];
+    events: string[];
+    seeded_records: {
+        collection: string;
+        id: string;
+        preview_data: true;
+    }[];
+    data_classification: 'synthetic_preview';
+    external_side_effects: 'simulated';
+    readiness: ProposalReadiness;
+    proposal: FeltDBProposalRecord;
+}
+/** Canonical human diagnostic used by CLI and Studio text surfaces. */
+export declare function renderProposalDiagnostic(proposal: FeltDBProposalRecord, options?: {
+    readiness?: ProposalReadiness;
+    history?: FeltDBProposalEvent[];
+    preview?: FeltDBProposalPreviewArtifact;
+}): string[];
+export interface ProposalStore {
+    get<T>(collection: string, id: string): Promise<T | undefined>;
+    list<T>(collection: string): Promise<T[]>;
+    create<T>(collection: string, id: string, value: T): Promise<void>;
+    replace<T>(collection: string, id: string, value: T): Promise<void>;
+}
+export interface ProposalContext {
+    source: string;
+    snapshot: FeltDBContractSnapshot;
+}
+export declare class FeltDBProposalService {
+    private store;
+    private context;
+    private repositoryAuthority?;
+    constructor(store: ProposalStore, context: () => Promise<ProposalContext>, repositoryAuthority?: string | undefined);
+    create(input: {
+        application_id: string;
+        environment: string;
+        base_contract_hash: string;
+        base_flow_hash: string;
+        proposed_flow: string;
+        summary: string;
+        warnings?: string[];
+        actor: string;
+        metadata?: Record<string, string>;
+        parent_proposal_id?: string;
+        expires_at?: string | number;
+    }): Promise<FeltDBProposalRecord>;
+    list(): Promise<FeltDBProposalRecord[]>;
+    get(id: string): Promise<FeltDBProposalRecord>;
+    history(id: string): Promise<FeltDBProposalEvent[]>;
+    readiness(id: string): Promise<ProposalReadiness>;
+    validate(id: string, actor: string): Promise<FeltDBProposalRecord>;
+    preview(id: string, actor: string): Promise<FeltDBProposalPreviewArtifact>;
+    getPreview(id: string): Promise<FeltDBProposalPreviewArtifact>;
+    transition(id: string, status: 'approved' | 'rejected' | 'expired' | 'applied', actor: string, authority?: string, approveAuthorization?: boolean): Promise<FeltDBProposalRecord>;
+    private assertMutable;
+    private move;
+    private event;
+}
+//# sourceMappingURL=proposal.d.ts.map

package/dist/proposal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposal.d.ts","sourceRoot":"","sources":["../src/proposal.ts"],"names":[],"mappings":"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"}