@butterbase/shared 0.2.0

package/dist/quota/quota-enforcer.js

@@ -0,0 +1,16 @@
+import { randomUUID } from 'node:crypto';
+export class UnlimitedQuotaEnforcer {
+    async acquireLease(_userId, _req) {
+        return {
+            granted: true,
+            leaseId: randomUUID(),
+            budgetUsd: Number.POSITIVE_INFINITY,
+            expiresAt: new Date(Date.now() + 24 * 60 * 60 * 1000),
+        };
+    }
+    async settleLease(_leaseId, _params) { }
+    async getRemaining(_userId, _kind) {
+        return Number.POSITIVE_INFINITY;
+    }
+}
+//# sourceMappingURL=quota-enforcer.js.map

package/dist/quota/quota-enforcer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-enforcer.js","sourceRoot":"","sources":["../../src/quota/quota-enforcer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA2BzC,MAAM,OAAO,sBAAsB;IACjC,KAAK,CAAC,YAAY,CAAC,OAAe,EAAE,IAAkB;QACpD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,UAAU,EAAE;YACrB,SAAS,EAAE,MAAM,CAAC,iBAAiB;YACnC,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;SACtD,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,WAAW,CAAC,QAAgB,EAAE,OAAqB,IAAkB,CAAC;IAC5E,KAAK,CAAC,YAAY,CAAC,OAAe,EAAE,KAAgB;QAClD,OAAO,MAAM,CAAC,iBAAiB,CAAC;IAClC,CAAC;CACF"}

package/dist/quota/quota-enforcer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=quota-enforcer.test.d.ts.map

package/dist/quota/quota-enforcer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-enforcer.test.d.ts","sourceRoot":"","sources":["../../src/quota/quota-enforcer.test.ts"],"names":[],"mappings":""}

package/dist/quota/quota-enforcer.test.js

@@ -0,0 +1,18 @@
+import { describe, it, expect } from 'vitest';
+import { UnlimitedQuotaEnforcer } from './index.js';
+describe('UnlimitedQuotaEnforcer', () => {
+    const enforcer = new UnlimitedQuotaEnforcer();
+    it('always grants a lease', async () => {
+        const lease = await enforcer.acquireLease('user-123', { kind: 'ai_credits' });
+        expect(lease.granted).toBe(true);
+        expect(lease.leaseId).toBeTruthy();
+    });
+    it('settle is a no-op', async () => {
+        await expect(enforcer.settleLease('lease-abc', { actualUsdSpent: 0.5 })).resolves.toBeUndefined();
+    });
+    it('getRemaining returns Infinity', async () => {
+        const remaining = await enforcer.getRemaining('user-123', 'ai_credits');
+        expect(remaining).toBe(Infinity);
+    });
+});
+//# sourceMappingURL=quota-enforcer.test.js.map

package/dist/quota/quota-enforcer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-enforcer.test.js","sourceRoot":"","sources":["../../src/quota/quota-enforcer.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAsB,MAAM,YAAY,CAAC;AAExE,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,MAAM,QAAQ,GAAkB,IAAI,sBAAsB,EAAE,CAAC;IAE7D,EAAE,CAAC,uBAAuB,EAAE,KAAK,IAAI,EAAE;QACrC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QAC9E,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE;QACjC,MAAM,MAAM,CACV,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,CAC3D,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACxE,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/regions.d.ts

@@ -0,0 +1,21 @@
+export declare class RegionConfigError extends Error {
+    constructor(message: string);
+}
+export declare function parseRegions(raw: string): string[];
+export declare function parseInstanceRegion(raw: string, allowed: string[]): string;
+export interface RegionConfig {
+    regions: string[];
+    instanceRegion: string;
+}
+export declare function parseFlyRegionMap(raw: string): Record<string, string>;
+export declare function loadRegionConfig(env: Record<string, string | undefined>): RegionConfig;
+export declare function regionToEnvSuffix(region: string): string;
+/**
+ * Given an AWS-style butterbase region (e.g. "us-west-2"), return the first
+ * Fly region code (e.g. "sjc") configured to serve it via BUTTERBASE_FLY_REGION_MAP.
+ * Fly load-balances across machines within the chosen fly region, so picking
+ * the first match is sufficient. Returns null when no fly region maps to the
+ * given butterbase region.
+ */
+export declare function butterbaseRegionToFlyRegion(butterbaseRegion: string, flyRegionMap: Record<string, string>): string | null;
+//# sourceMappingURL=regions.d.ts.map

package/dist/regions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regions.d.ts","sourceRoot":"","sources":["../src/regions.ts"],"names":[],"mappings":"AAAA,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAID,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAwBlD;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAW1E;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBrE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,YAAY,CAqCtF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,MAAM,GAAG,IAAI,CAKf"}

package/dist/regions.js

@@ -0,0 +1,115 @@
+export class RegionConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'RegionConfigError';
+    }
+}
+const REGION_PATTERN = /^[a-z]+(-[a-z0-9]+)+$/;
+export function parseRegions(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        throw new RegionConfigError('BUTTERBASE_REGIONS is empty');
+    }
+    const items = trimmed.split(',').map((s) => s.trim()).filter(Boolean);
+    if (items.length === 0) {
+        throw new RegionConfigError('BUTTERBASE_REGIONS contained no usable values');
+    }
+    for (const item of items) {
+        if (!REGION_PATTERN.test(item)) {
+            throw new RegionConfigError(`Invalid region "${item}". Expected lowercase, hyphen-separated (e.g. us-east-1).`);
+        }
+    }
+    const seen = new Set();
+    for (const item of items) {
+        if (seen.has(item)) {
+            throw new RegionConfigError(`Duplicate region in BUTTERBASE_REGIONS: ${item}`);
+        }
+        seen.add(item);
+    }
+    return items;
+}
+export function parseInstanceRegion(raw, allowed) {
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        throw new RegionConfigError('BUTTERBASE_REGION is empty');
+    }
+    if (!allowed.includes(trimmed)) {
+        throw new RegionConfigError(`BUTTERBASE_REGION "${trimmed}" is not in BUTTERBASE_REGIONS [${allowed.join(',')}]`);
+    }
+    return trimmed;
+}
+export function parseFlyRegionMap(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        throw new RegionConfigError('BUTTERBASE_FLY_REGION_MAP is empty');
+    }
+    const entries = trimmed.split(',').map((s) => s.trim()).filter(Boolean);
+    const map = {};
+    for (const entry of entries) {
+        const idx = entry.indexOf(':');
+        if (idx <= 0 || idx === entry.length - 1) {
+            throw new RegionConfigError(`Malformed entry "${entry}" in BUTTERBASE_FLY_REGION_MAP. Expected format: <fly_region>:<butterbase_region>`);
+        }
+        const flyRegion = entry.slice(0, idx).trim();
+        const butterbaseRegion = entry.slice(idx + 1).trim();
+        if (!flyRegion || !butterbaseRegion) {
+            throw new RegionConfigError(`Empty key or value in entry "${entry}"`);
+        }
+        if (map[flyRegion] !== undefined) {
+            throw new RegionConfigError(`Duplicate Fly region key "${flyRegion}" in BUTTERBASE_FLY_REGION_MAP`);
+        }
+        map[flyRegion] = butterbaseRegion;
+    }
+    return map;
+}
+export function loadRegionConfig(env) {
+    const regionsRaw = env.BUTTERBASE_REGIONS;
+    if (regionsRaw === undefined) {
+        throw new RegionConfigError('BUTTERBASE_REGIONS env var is not set');
+    }
+    const regions = parseRegions(regionsRaw);
+    // Resolution order:
+    //   1. Explicit BUTTERBASE_REGION (operator override / local dev)
+    //   2. Derive from FLY_REGION via BUTTERBASE_FLY_REGION_MAP (production on Fly)
+    let instanceRegion;
+    const explicit = env.BUTTERBASE_REGION;
+    if (explicit !== undefined) {
+        const stripped = explicit.trim();
+        if (!stripped) {
+            throw new RegionConfigError('BUTTERBASE_REGION is set but empty');
+        }
+        instanceRegion = parseInstanceRegion(stripped, regions);
+    }
+    else {
+        const flyRegion = env.FLY_REGION;
+        const mapRaw = env.BUTTERBASE_FLY_REGION_MAP;
+        if (!flyRegion || !mapRaw) {
+            throw new RegionConfigError('BUTTERBASE_REGION env var is not set, and no FLY_REGION + BUTTERBASE_FLY_REGION_MAP available to derive from');
+        }
+        const map = parseFlyRegionMap(mapRaw);
+        const derived = map[flyRegion];
+        if (!derived) {
+            throw new RegionConfigError(`FLY_REGION "${flyRegion}" has no entry in BUTTERBASE_FLY_REGION_MAP`);
+        }
+        instanceRegion = parseInstanceRegion(derived, regions);
+    }
+    return { regions, instanceRegion };
+}
+export function regionToEnvSuffix(region) {
+    return region.toUpperCase().replace(/-/g, '_');
+}
+/**
+ * Given an AWS-style butterbase region (e.g. "us-west-2"), return the first
+ * Fly region code (e.g. "sjc") configured to serve it via BUTTERBASE_FLY_REGION_MAP.
+ * Fly load-balances across machines within the chosen fly region, so picking
+ * the first match is sufficient. Returns null when no fly region maps to the
+ * given butterbase region.
+ */
+export function butterbaseRegionToFlyRegion(butterbaseRegion, flyRegionMap) {
+    for (const [fly, bb] of Object.entries(flyRegionMap)) {
+        if (bb === butterbaseRegion)
+            return fly;
+    }
+    return null;
+}
+//# sourceMappingURL=regions.js.map

package/dist/regions.js.map

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

package/dist/regions.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=regions.test.d.ts.map

package/dist/regions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regions.test.d.ts","sourceRoot":"","sources":["../src/regions.test.ts"],"names":[],"mappings":""}

package/dist/regions.test.js

@@ -0,0 +1,129 @@
+import { describe, it, expect } from 'vitest';
+import { parseRegions, parseInstanceRegion, loadRegionConfig, RegionConfigError } from './regions.js';
+describe('parseRegions', () => {
+    it('parses a comma-separated list, trimming whitespace', () => {
+        expect(parseRegions('us-east-1, eu-west-1, ap-southeast-1')).toEqual([
+            'us-east-1',
+            'eu-west-1',
+            'ap-southeast-1',
+        ]);
+    });
+    it('parses a single-region list', () => {
+        expect(parseRegions('us-east-1')).toEqual(['us-east-1']);
+    });
+    it('throws on empty input', () => {
+        expect(() => parseRegions('')).toThrow(RegionConfigError);
+        expect(() => parseRegions('   ')).toThrow(RegionConfigError);
+    });
+    it('throws on duplicate regions', () => {
+        expect(() => parseRegions('us-east-1,us-east-1')).toThrow(/duplicate/i);
+    });
+    it('throws on invalid format', () => {
+        expect(() => parseRegions('US_EAST_1')).toThrow(/lowercase/i);
+        expect(() => parseRegions('us east 1')).toThrow();
+    });
+});
+describe('parseInstanceRegion', () => {
+    it('returns the region when present in the allowed list', () => {
+        expect(parseInstanceRegion('us-east-1', ['us-east-1', 'eu-west-1'])).toEqual('us-east-1');
+    });
+    it('throws when region is not in the allowed list', () => {
+        expect(() => parseInstanceRegion('eu-west-1', ['us-east-1'])).toThrow(/not in BUTTERBASE_REGIONS/);
+    });
+    it('throws on empty input', () => {
+        expect(() => parseInstanceRegion('', ['us-east-1'])).toThrow(RegionConfigError);
+    });
+});
+describe('loadRegionConfig', () => {
+    it('returns regions and instanceRegion when env is well-formed', () => {
+        const cfg = loadRegionConfig({
+            BUTTERBASE_REGIONS: 'us-east-1,eu-west-1',
+            BUTTERBASE_REGION: 'us-east-1',
+        });
+        expect(cfg).toEqual({ regions: ['us-east-1', 'eu-west-1'], instanceRegion: 'us-east-1' });
+    });
+    it('throws when BUTTERBASE_REGIONS is missing', () => {
+        expect(() => loadRegionConfig({ BUTTERBASE_REGION: 'us-east-1' })).toThrow(/BUTTERBASE_REGIONS/);
+    });
+    it('throws when BUTTERBASE_REGION is missing', () => {
+        expect(() => loadRegionConfig({ BUTTERBASE_REGIONS: 'us-east-1' })).toThrow(/BUTTERBASE_REGION/);
+    });
+    it('throws when instance region is not in the list', () => {
+        expect(() => loadRegionConfig({ BUTTERBASE_REGIONS: 'us-east-1', BUTTERBASE_REGION: 'eu-west-1' })).toThrow(/not in BUTTERBASE_REGIONS/);
+    });
+});
+describe('regionToEnvSuffix', () => {
+    it('uppercases and replaces hyphens with underscores', async () => {
+        const { regionToEnvSuffix } = await import('./regions.js');
+        expect(regionToEnvSuffix('us-east-1')).toEqual('US_EAST_1');
+        expect(regionToEnvSuffix('eu-west-1')).toEqual('EU_WEST_1');
+    });
+});
+describe('parseFlyRegionMap', () => {
+    it('parses a comma-separated map', async () => {
+        const { parseFlyRegionMap } = await import('./regions.js');
+        expect(parseFlyRegionMap('iad:us-east-1,lhr:eu-west-1')).toEqual({
+            iad: 'us-east-1',
+            lhr: 'eu-west-1',
+        });
+    });
+    it('throws on malformed entry', async () => {
+        const { parseFlyRegionMap, RegionConfigError } = await import('./regions.js');
+        expect(() => parseFlyRegionMap('iad-us-east-1')).toThrow(RegionConfigError);
+        expect(() => parseFlyRegionMap('iad:')).toThrow(RegionConfigError);
+        expect(() => parseFlyRegionMap(':us-east-1')).toThrow(RegionConfigError);
+    });
+    it('throws on empty input', async () => {
+        const { parseFlyRegionMap, RegionConfigError } = await import('./regions.js');
+        expect(() => parseFlyRegionMap('')).toThrow(RegionConfigError);
+    });
+    it('throws on duplicate Fly region keys', async () => {
+        const { parseFlyRegionMap } = await import('./regions.js');
+        expect(() => parseFlyRegionMap('iad:us-east-1,iad:us-east-2')).toThrow(/duplicate/i);
+    });
+});
+describe('loadRegionConfig with FLY_REGION derivation', () => {
+    it('derives instanceRegion from FLY_REGION + BUTTERBASE_FLY_REGION_MAP when BUTTERBASE_REGION is unset', () => {
+        const cfg = loadRegionConfig({
+            BUTTERBASE_REGIONS: 'us-east-1,eu-west-1',
+            BUTTERBASE_FLY_REGION_MAP: 'iad:us-east-1,lhr:eu-west-1',
+            FLY_REGION: 'lhr',
+        });
+        expect(cfg.instanceRegion).toEqual('eu-west-1');
+    });
+    it('prefers explicit BUTTERBASE_REGION over derivation', () => {
+        const cfg = loadRegionConfig({
+            BUTTERBASE_REGIONS: 'us-east-1,eu-west-1',
+            BUTTERBASE_REGION: 'us-east-1',
+            BUTTERBASE_FLY_REGION_MAP: 'iad:us-east-1,lhr:eu-west-1',
+            FLY_REGION: 'lhr',
+        });
+        expect(cfg.instanceRegion).toEqual('us-east-1');
+    });
+    it('throws when FLY_REGION is set but no map entry exists', () => {
+        expect(() => loadRegionConfig({
+            BUTTERBASE_REGIONS: 'us-east-1,eu-west-1',
+            BUTTERBASE_FLY_REGION_MAP: 'iad:us-east-1',
+            FLY_REGION: 'lhr',
+        })).toThrow(/FLY_REGION "lhr" has no entry in BUTTERBASE_FLY_REGION_MAP/);
+    });
+    it('throws when neither BUTTERBASE_REGION nor (FLY_REGION + map) is provided', () => {
+        expect(() => loadRegionConfig({ BUTTERBASE_REGIONS: 'us-east-1' })).toThrow(/BUTTERBASE_REGION/);
+    });
+    it('derived instanceRegion must still be in BUTTERBASE_REGIONS', () => {
+        expect(() => loadRegionConfig({
+            BUTTERBASE_REGIONS: 'us-east-1',
+            BUTTERBASE_FLY_REGION_MAP: 'lhr:eu-west-1',
+            FLY_REGION: 'lhr',
+        })).toThrow(/not in BUTTERBASE_REGIONS/);
+    });
+    it('throws when BUTTERBASE_REGION is set but empty (does not silently fall through to FLY_REGION)', () => {
+        expect(() => loadRegionConfig({
+            BUTTERBASE_REGIONS: 'us-east-1,eu-west-1',
+            BUTTERBASE_REGION: '',
+            BUTTERBASE_FLY_REGION_MAP: 'iad:us-east-1,lhr:eu-west-1',
+            FLY_REGION: 'lhr',
+        })).toThrow(/BUTTERBASE_REGION is set but empty/);
+    });
+});
+//# sourceMappingURL=regions.test.js.map

package/dist/regions.test.js.map

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

package/dist/response-types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Next action suggestion for agents
+ */
+export interface NextAction {
+    action: string;
+    description: string;
+    recommended: boolean;
+}
+/**
+ * Resource usage information
+ */
+export interface ResourceInfo {
+    quota_used?: number;
+    quota_limit?: number;
+    rate_limit_remaining?: number;
+    /** Storage used in bytes */
+    storage_used_bytes?: number;
+    /** Storage limit in bytes */
+    storage_limit_bytes?: number;
+    /** Storage used as percentage (0-100) */
+    storage_used_percent?: number;
+    /** Number of files stored */
+    files_count?: number;
+    /** Number of tables in database */
+    tables_count?: number;
+    /** Maximum tables allowed */
+    tables_limit?: number;
+}
+/**
+ * Response metadata for agent guidance
+ */
+export interface ResponseMetadata {
+    next_actions?: NextAction[];
+    resource_info?: ResourceInfo;
+}
+/**
+ * Generic response wrapper with metadata
+ */
+export type ResponseWithMetadata<T> = T & {
+    _meta?: ResponseMetadata;
+};
+//# sourceMappingURL=response-types.d.ts.map

package/dist/response-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-types.d.ts","sourceRoot":"","sources":["../src/response-types.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,4BAA4B;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,6BAA6B;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yCAAyC;IACzC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,YAAY,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAAE,CAAA"}

package/dist/response-types.js

@@ -0,0 +1,3 @@
+// packages/shared/src/response-types.ts
+export {};
+//# sourceMappingURL=response-types.js.map

package/dist/response-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-types.js","sourceRoot":"","sources":["../src/response-types.ts"],"names":[],"mappings":"AAAA,wCAAwC"}

package/dist/schema-dsl.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Schema DSL types for Butterbase declarative schema management.
+ * These types represent the desired state of an app's database schema.
+ */
+export interface ColumnDef {
+    type: string;
+    primaryKey?: boolean;
+    nullable?: boolean;
+    default?: string;
+    unique?: boolean;
+    references?: string;
+}
+export interface IndexDef {
+    columns: string[];
+    unique?: boolean;
+    method?: string;
+    opclass?: string;
+}
+export interface TableDef {
+    columns: Record<string, ColumnDef>;
+    indexes?: Record<string, IndexDef>;
+    _dropColumns?: string[];
+}
+export interface SchemaDSL {
+    tables: Record<string, TableDef>;
+    _drop?: string[];
+}
+//# sourceMappingURL=schema-dsl.d.ts.map

package/dist/schema-dsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-dsl.d.ts","sourceRoot":"","sources":["../src/schema-dsl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/schema-dsl.js

@@ -0,0 +1,6 @@
+/**
+ * Schema DSL types for Butterbase declarative schema management.
+ * These types represent the desired state of an app's database schema.
+ */
+export {};
+//# sourceMappingURL=schema-dsl.js.map

package/dist/schema-dsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-dsl.js","sourceRoot":"","sources":["../src/schema-dsl.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types.d.ts

@@ -0,0 +1,155 @@
+export interface PlatformUser {
+    id: string;
+    email: string;
+    password_hash: string;
+    display_name: string | null;
+    created_at: Date;
+    updated_at: Date;
+}
+export interface App {
+    id: string;
+    name: string;
+    owner_id: string;
+    db_name: string;
+    db_provisioned: boolean;
+    region: string;
+    created_at: Date;
+    updated_at: Date;
+}
+export interface AppUser {
+    id: string;
+    app_id: string;
+    email: string;
+    password_hash: string | null;
+    provider: string;
+    provider_uid: string | null;
+    metadata: Record<string, unknown>;
+    email_verified: boolean;
+    display_name: string | null;
+    avatar_url: string | null;
+    last_sign_in_at: Date | null;
+    created_at: Date;
+    updated_at: Date;
+}
+export interface StorageObject {
+    id: string;
+    app_id: string;
+    bucket: string;
+    key: string;
+    size_bytes: number | null;
+    mime_type: string | null;
+    metadata: Record<string, unknown>;
+    created_at: Date;
+}
+export interface AiUsageLog {
+    id: string;
+    app_id: string;
+    model: string;
+    provider: string;
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+    cost_usd: number | null;
+    request_metadata: Record<string, unknown>;
+    created_at: Date;
+}
+export interface InitRequest {
+    name: string;
+    owner_id?: string;
+}
+export interface InitResponse {
+    app_id: string;
+    name: string;
+    database: {
+        host: string;
+        port: number;
+        name: string;
+        user: string;
+        connection_string: string;
+    };
+    api_url: string;
+    created_at: string;
+    _meta?: {
+        next_actions?: Array<{
+            action: string;
+            description: string;
+            recommended: boolean;
+        }>;
+    };
+}
+export interface ApiKey {
+    id: string;
+    user_id: string;
+    key_prefix: string;
+    name: string;
+    scopes: string[];
+    last_used_at?: Date;
+    expires_at?: Date;
+    revoked_at?: Date;
+    created_at: Date;
+}
+export interface AuthContext {
+    userId: string | null;
+    authMethod: 'api_key' | 'jwt' | 'end_user_jwt' | 'anonymous';
+    scopes: string[];
+    keyId?: string;
+    email?: string;
+    appId?: string;
+    rawToken?: string;
+}
+export interface AppSigningKey {
+    id: string;
+    app_id: string;
+    kid: string;
+    algorithm: string;
+    private_key_encrypted: string;
+    public_key: string;
+    active: boolean;
+    created_at: Date;
+}
+export interface AppOAuthConfig {
+    id: string;
+    app_id: string;
+    provider: string;
+    client_id: string;
+    client_secret_encrypted: string | null;
+    scopes: string[];
+    authorization_url: string | null;
+    token_url: string | null;
+    userinfo_url: string | null;
+    enabled: boolean;
+}
+export interface AppRefreshToken {
+    id: string;
+    app_id: string;
+    user_id: string;
+    token_hash: string;
+    expires_at: Date;
+    revoked_at: Date | null;
+}
+export interface EndUserClaims {
+    sub: string;
+    email: string;
+    email_verified: boolean;
+    app_id: string;
+    iat: number;
+    exp: number;
+    iss: string;
+}
+export interface EndUserAuthContext {
+    userId: string;
+    appId: string;
+    email: string;
+    emailVerified: boolean;
+}
+export interface RealtimeEvent {
+    type: 'change';
+    table: string;
+    op: 'INSERT' | 'UPDATE' | 'DELETE';
+    record: Record<string, unknown> | null;
+    old_record: Record<string, unknown> | null;
+    timestamp: string;
+}
+export * from './error-types.js';
+export * from './response-types.js';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+export * from './error-types.js';
+export * from './response-types.js';
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAuKA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}