@bubltec/mycota-jobs 0.2.0

package/dist/eventbridge.adapter.d.ts

@@ -0,0 +1,35 @@
+import type { Job, JobScheduler, ScheduleJobInput } from './ports.js';
+/**
+ * Narrow EventBridge Scheduler surface. The consuming app passes the AWS
+ * client (or a test double). Schedules target a queue/Lambda the app owns.
+ */
+export interface SchedulerClient {
+    createSchedule(input: {
+        name: string;
+        runAt: string;
+        payload: string;
+    }): Promise<void>;
+    deleteSchedule(name: string): Promise<void>;
+}
+export interface EventBridgeJobSchedulerOptions {
+    /** Prefix applied to schedule names (EventBridge: [0-9a-zA-Z-_.]{1,64}). */
+    namePrefix?: string;
+}
+declare function scheduleName(prefix: string, id: string): string;
+declare function atExpression(runAt: string): string;
+/**
+ * One-time schedules via EventBridge Scheduler `at()`. Does not poll — AWS
+ * invokes the target at `runAt`. `get` only sees jobs this process scheduled.
+ */
+export declare class EventBridgeJobScheduler implements JobScheduler {
+    private readonly client;
+    private readonly options;
+    private readonly local;
+    private seq;
+    constructor(client: SchedulerClient, options?: EventBridgeJobSchedulerOptions);
+    schedule(input: ScheduleJobInput): Promise<Job>;
+    cancel(id: string): Promise<void>;
+    get(id: string): Promise<Job | undefined>;
+}
+export { atExpression, scheduleName };
+//# sourceMappingURL=eventbridge.adapter.d.ts.map

package/dist/eventbridge.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventbridge.adapter.d.ts","sourceRoot":"","sources":["../src/eventbridge.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,KAAK,EAAE;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,8BAA8B;IAC7C,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,iBAAS,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,iBAAS,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG3C;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,YAAY;IAKxD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAChD,OAAO,CAAC,GAAG,CAAK;gBAGG,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,8BAAmC;IAGzD,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC;IAqB/C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC;CAIhD;AAED,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/eventbridge.adapter.js

@@ -0,0 +1,56 @@
+function scheduleName(prefix, id) {
+    const raw = `${prefix}${id}`.replace(/[^0-9a-zA-Z-_.]/g, '-');
+    return raw.slice(0, 64);
+}
+function atExpression(runAt) {
+    const iso = new Date(runAt).toISOString().replace(/\.\d{3}Z$/, '');
+    return `at(${iso})`;
+}
+/**
+ * One-time schedules via EventBridge Scheduler `at()`. Does not poll — AWS
+ * invokes the target at `runAt`. `get` only sees jobs this process scheduled.
+ */
+export class EventBridgeJobScheduler {
+    client;
+    options;
+    local = new Map();
+    seq = 0;
+    constructor(client, options = {}) {
+        this.client = client;
+        this.options = options;
+    }
+    async schedule(input) {
+        if (!input.name)
+            throw new Error('job name is required');
+        this.seq += 1;
+        const id = `job_${this.seq}_${Date.now()}`;
+        const job = {
+            id,
+            name: input.name,
+            payload: input.payload,
+            runAt: input.runAt ?? new Date().toISOString(),
+            status: 'scheduled',
+            attempts: 0,
+        };
+        await this.client.createSchedule({
+            name: scheduleName(this.options.namePrefix ?? 'mycota-', job.id),
+            runAt: atExpression(job.runAt),
+            payload: JSON.stringify({ id: job.id, name: job.name, payload: job.payload, runAt: job.runAt }),
+        });
+        this.local.set(job.id, job);
+        return job;
+    }
+    async cancel(id) {
+        const job = this.local.get(id);
+        if (!job)
+            throw new Error(`job ${id} not found`);
+        await this.client.deleteSchedule(scheduleName(this.options.namePrefix ?? 'mycota-', id));
+        job.status = 'cancelled';
+    }
+    async get(id) {
+        const job = this.local.get(id);
+        return job ? { ...job } : undefined;
+    }
+}
+export { atExpression, scheduleName };
+//# sourceMappingURL=eventbridge.adapter.js.map

package/dist/eventbridge.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventbridge.adapter.js","sourceRoot":"","sources":["../src/eventbridge.adapter.ts"],"names":[],"mappings":"AAoBA,SAAS,YAAY,CAAC,MAAc,EAAE,EAAU;IAC9C,MAAM,GAAG,GAAG,GAAG,MAAM,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAC9D,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACnE,OAAO,MAAM,GAAG,GAAG,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,uBAAuB;IAKf;IACA;IALF,KAAK,GAAG,IAAI,GAAG,EAAe,CAAC;IACxC,GAAG,GAAG,CAAC,CAAC;IAEhB,YACmB,MAAuB,EACvB,UAA0C,EAAE;QAD5C,WAAM,GAAN,MAAM,CAAiB;QACvB,YAAO,GAAP,OAAO,CAAqC;IAC5D,CAAC;IAEJ,KAAK,CAAC,QAAQ,CAAC,KAAuB;QACpC,IAAI,CAAC,KAAK,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QACzD,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;QACd,MAAM,EAAE,GAAG,OAAO,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAQ;YACf,EAAE;YACF,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC9C,MAAM,EAAE,WAAW;YACnB,QAAQ,EAAE,CAAC;SACZ,CAAC;QACF,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;YAC/B,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC;YAChE,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC;YAC9B,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;SAChG,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC5B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACjD,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC;QACzF,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/B,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACtC,CAAC;CACF;AAED,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/fake.adapter.d.ts

@@ -0,0 +1,21 @@
+import type { Job, JobHandler, JobScheduler, ScheduleJobInput } from './ports.js';
+export interface FakeJobSchedulerOptions {
+    clock?: () => Date;
+    maxAttempts?: number;
+}
+/**
+ * In-memory scheduler. `processDue` is the local stand-in for EventBridge
+ * invoking the worker at `runAt`.
+ */
+export declare class FakeJobScheduler implements JobScheduler {
+    private readonly options;
+    readonly jobs: Map<string, Job>;
+    private seq;
+    constructor(options?: FakeJobSchedulerOptions);
+    schedule(input: ScheduleJobInput): Promise<Job>;
+    cancel(id: string): Promise<void>;
+    get(id: string): Promise<Job | undefined>;
+    processDue(handler: JobHandler, now?: Date): Promise<number>;
+    private now;
+}
+//# sourceMappingURL=fake.adapter.d.ts.map

package/dist/fake.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake.adapter.d.ts","sourceRoot":"","sources":["../src/fake.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAElF,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IAIvC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,IAAI,mBAA0B;IACvC,OAAO,CAAC,GAAG,CAAK;gBAEa,OAAO,GAAE,uBAA4B;IAE5D,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC;IAe/C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC;IAKzC,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,OAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBxE,OAAO,CAAC,GAAG;CAGZ"}

package/dist/fake.adapter.js

@@ -0,0 +1,61 @@
+/**
+ * In-memory scheduler. `processDue` is the local stand-in for EventBridge
+ * invoking the worker at `runAt`.
+ */
+export class FakeJobScheduler {
+    options;
+    jobs = new Map();
+    seq = 0;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async schedule(input) {
+        if (!input.name)
+            throw new Error('job name is required');
+        this.seq += 1;
+        const job = {
+            id: `job_fake_${this.seq}`,
+            name: input.name,
+            payload: input.payload,
+            runAt: input.runAt ?? this.now().toISOString(),
+            status: 'scheduled',
+            attempts: 0,
+        };
+        this.jobs.set(job.id, job);
+        return job;
+    }
+    async cancel(id) {
+        const job = this.jobs.get(id);
+        if (!job)
+            throw new Error(`job ${id} not found`);
+        if (job.status === 'succeeded' || job.status === 'cancelled')
+            return;
+        job.status = 'cancelled';
+    }
+    async get(id) {
+        const job = this.jobs.get(id);
+        return job ? { ...job } : undefined;
+    }
+    async processDue(handler, now = this.now()) {
+        const maxAttempts = this.options.maxAttempts ?? 5;
+        const due = [...this.jobs.values()].filter((job) => job.status === 'scheduled' && new Date(job.runAt).getTime() <= now.getTime());
+        let ran = 0;
+        for (const job of due) {
+            job.status = 'running';
+            job.attempts += 1;
+            try {
+                await handler({ ...job });
+                job.status = 'succeeded';
+            }
+            catch {
+                job.status = job.attempts >= maxAttempts ? 'failed' : 'scheduled';
+            }
+            ran += 1;
+        }
+        return ran;
+    }
+    now() {
+        return this.options.clock?.() ?? new Date();
+    }
+}
+//# sourceMappingURL=fake.adapter.js.map

package/dist/fake.adapter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export type { Job, JobHandler, JobScheduler, JobStatus, ScheduleJobInput } from './ports.js';
+export { FakeJobScheduler, type FakeJobSchedulerOptions } from './fake.adapter.js';
+export { EventBridgeJobScheduler, atExpression, scheduleName, type EventBridgeJobSchedulerOptions, type SchedulerClient, } from './eventbridge.adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EACL,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,KAAK,8BAA8B,EACnC,KAAK,eAAe,GACrB,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { FakeJobScheduler } from './fake.adapter.js';
+export { EventBridgeJobScheduler, atExpression, scheduleName, } from './eventbridge.adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAgC,MAAM,mBAAmB,CAAC;AACnF,OAAO,EACL,uBAAuB,EACvB,YAAY,EACZ,YAAY,GAGb,MAAM,0BAA0B,CAAC"}

package/dist/jobs.spec.d.ts

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

package/dist/jobs.spec.d.ts.map

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

package/dist/jobs.spec.js

@@ -0,0 +1,60 @@
+import { describe, expect, it, vi } from 'vitest';
+import { EventBridgeJobScheduler, atExpression } from './eventbridge.adapter.js';
+import { FakeJobScheduler } from './fake.adapter.js';
+describe('FakeJobScheduler', () => {
+    it('runs due jobs and retries failures until maxAttempts', async () => {
+        const scheduler = new FakeJobScheduler({
+            clock: () => new Date('2026-09-01T12:00:00.000Z'),
+            maxAttempts: 2,
+        });
+        await scheduler.schedule({
+            name: 'campaign.publish',
+            payload: { beat: 'announce' },
+            runAt: '2026-09-01T11:00:00.000Z',
+        });
+        await scheduler.schedule({
+            name: 'campaign.publish',
+            payload: { beat: 'day_of' },
+            runAt: '2026-09-02T20:00:00.000Z',
+        });
+        const ran = await scheduler.processDue(async (job) => {
+            if (job.payload && typeof job.payload === 'object' && 'beat' in job.payload) {
+                throw new Error('boom');
+            }
+        });
+        expect(ran).toBe(1);
+        expect((await scheduler.get('job_fake_1'))?.status).toBe('scheduled');
+        await scheduler.processDue(async () => {
+            throw new Error('boom');
+        });
+        expect((await scheduler.get('job_fake_1'))?.status).toBe('failed');
+        expect((await scheduler.get('job_fake_2'))?.status).toBe('scheduled');
+    });
+    it('cancel is a no-op after success', async () => {
+        const scheduler = new FakeJobScheduler();
+        const job = await scheduler.schedule({ name: 'ping', payload: {} });
+        await scheduler.processDue(async () => undefined);
+        await scheduler.cancel(job.id);
+        expect((await scheduler.get(job.id))?.status).toBe('succeeded');
+    });
+});
+describe('EventBridgeJobScheduler', () => {
+    it('creates an at() schedule and cancels by name', async () => {
+        const client = {
+            createSchedule: vi.fn(async () => undefined),
+            deleteSchedule: vi.fn(async () => undefined),
+        };
+        const scheduler = new EventBridgeJobScheduler(client, { namePrefix: 'sloth-' });
+        const job = await scheduler.schedule({
+            name: 'campaign.publish',
+            payload: { eventId: 'e1' },
+            runAt: '2026-09-01T20:00:00.000Z',
+        });
+        expect(client.createSchedule).toHaveBeenCalledWith(expect.objectContaining({
+            runAt: atExpression('2026-09-01T20:00:00.000Z'),
+        }));
+        await scheduler.cancel(job.id);
+        expect(client.deleteSchedule).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=jobs.spec.js.map

package/dist/jobs.spec.js.map

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

package/dist/ports.d.ts

@@ -0,0 +1,27 @@
+export type JobStatus = 'scheduled' | 'running' | 'succeeded' | 'failed' | 'cancelled';
+export interface ScheduleJobInput {
+    name: string;
+    payload: unknown;
+    /** ISO-8601. Defaults to now — the next `processDue` (fake) or the worker (prod) runs it. */
+    runAt?: string;
+}
+export interface Job {
+    id: string;
+    name: string;
+    payload: unknown;
+    runAt: string;
+    status: JobStatus;
+    attempts: number;
+}
+/**
+ * Delayed work: campaign beats, payout retries, token refresh. SQS delay is
+ * capped at 15 minutes, so production uses EventBridge Scheduler `at()`, not
+ * a delayed SQS send. Local/tests use FakeJobScheduler.processDue.
+ */
+export interface JobScheduler {
+    schedule(input: ScheduleJobInput): Promise<Job>;
+    cancel(id: string): Promise<void>;
+    get(id: string): Promise<Job | undefined>;
+}
+export type JobHandler = (job: Job) => Promise<void>;
+//# sourceMappingURL=ports.d.ts.map

package/dist/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../src/ports.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEvF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;CAC3C;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/ports.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/ports.js.map

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

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@bubltec/mycota-jobs",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b --noEmit",
+    "lint": "oxlint -c ../../.oxlintrc.json src",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.8.0",
+    "vitest": "^2.1.0"
+  }
+}