@sudobility/ratelimit_service 1.0.1

package/dist/schema/rate-limits.d.ts

@@ -0,0 +1,333 @@
+/**
+ * Drizzle schema and database initialization for rate limit tracking.
+ *
+ * Provides:
+ * - createRateLimitCountersTable: Factory for Drizzle table with custom schema
+ * - initRateLimitTable: SQL initialization for the table
+ * - Default rateLimitCounters table for public schema
+ */
+/**
+ * Create a rate limit counters table for a specific PostgreSQL schema.
+ *
+ * @param schema - The Drizzle pgSchema object (e.g., pgSchema("shapeshyft"))
+ * @param indexPrefix - Prefix for index names to avoid conflicts
+ * @returns Drizzle table definition
+ *
+ * @example
+ * ```typescript
+ * import { pgSchema } from "drizzle-orm/pg-core";
+ * import { createRateLimitCountersTable } from "@sudobility/ratelimit_service";
+ *
+ * const mySchema = pgSchema("myapp");
+ * export const rateLimitCounters = createRateLimitCountersTable(mySchema, "myapp");
+ * ```
+ */
+export declare function createRateLimitCountersTable(schema: any, indexPrefix: string): any;
+/**
+ * Create a rate limit counters table for the public schema.
+ *
+ * @param indexPrefix - Prefix for index names
+ * @returns Drizzle table definition
+ *
+ * @example
+ * ```typescript
+ * import { createRateLimitCountersTablePublic } from "@sudobility/ratelimit_service";
+ *
+ * export const rateLimitCounters = createRateLimitCountersTablePublic("sudojo");
+ * ```
+ */
+export declare function createRateLimitCountersTablePublic(indexPrefix: string): import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "rate_limit_counters";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "rate_limit_counters";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        user_id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "user_id";
+            tableName: "rate_limit_counters";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: 128;
+        }>;
+        period_type: import("drizzle-orm/pg-core").PgColumn<{
+            name: "period_type";
+            tableName: "rate_limit_counters";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: 16;
+        }>;
+        period_start: import("drizzle-orm/pg-core").PgColumn<{
+            name: "period_start";
+            tableName: "rate_limit_counters";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        request_count: import("drizzle-orm/pg-core").PgColumn<{
+            name: "request_count";
+            tableName: "rate_limit_counters";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        created_at: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "rate_limit_counters";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updated_at: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "rate_limit_counters";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+/**
+ * Default rate limit counters table for public schema.
+ * Use createRateLimitCountersTable for custom schemas.
+ */
+export declare const rateLimitCounters: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "rate_limit_counters";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "rate_limit_counters";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        user_id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "user_id";
+            tableName: "rate_limit_counters";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: 128;
+        }>;
+        period_type: import("drizzle-orm/pg-core").PgColumn<{
+            name: "period_type";
+            tableName: "rate_limit_counters";
+            dataType: "string";
+            columnType: "PgVarchar";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: 16;
+        }>;
+        period_start: import("drizzle-orm/pg-core").PgColumn<{
+            name: "period_start";
+            tableName: "rate_limit_counters";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        request_count: import("drizzle-orm/pg-core").PgColumn<{
+            name: "request_count";
+            tableName: "rate_limit_counters";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        created_at: import("drizzle-orm/pg-core").PgColumn<{
+            name: "created_at";
+            tableName: "rate_limit_counters";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updated_at: import("drizzle-orm/pg-core").PgColumn<{
+            name: "updated_at";
+            tableName: "rate_limit_counters";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+/**
+ * TypeScript type for the rate_limit_counters table row (select)
+ */
+export type RateLimitCounterRecord = typeof rateLimitCounters.$inferSelect;
+/**
+ * TypeScript type for inserting into rate_limit_counters table
+ */
+export type NewRateLimitCounterRecord = typeof rateLimitCounters.$inferInsert;
+/**
+ * Initialize the rate limit counters table in the database.
+ *
+ * @param client - postgres-js client instance
+ * @param schemaName - PostgreSQL schema name (e.g., "shapeshyft", "whisperly", or null for public)
+ * @param indexPrefix - Prefix for index names to avoid conflicts
+ *
+ * @example
+ * ```typescript
+ * import postgres from "postgres";
+ * import { initRateLimitTable } from "@sudobility/ratelimit_service";
+ *
+ * const client = postgres(connectionString);
+ *
+ * // For public schema
+ * await initRateLimitTable(client, null, "sudojo");
+ *
+ * // For custom schema
+ * await initRateLimitTable(client, "shapeshyft", "shapeshyft");
+ * ```
+ */
+export declare function initRateLimitTable(client: ReturnType<typeof import("postgres")>, schemaName: string | null, indexPrefix: string): Promise<void>;
+//# sourceMappingURL=rate-limits.d.ts.map

package/dist/schema/rate-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limits.d.ts","sourceRoot":"","sources":["../../src/schema/rate-limits.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,GAAG,EACX,WAAW,EAAE,MAAM,OAyBpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kCAAkC,CAAC,WAAW,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwBrE;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsB7B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,iBAAiB,CAAC,YAAY,CAAC;AAE3E;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,OAAO,iBAAiB,CAAC,YAAY,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,UAAU,CAAC,cAAc,UAAU,CAAC,CAAC,EAC7C,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CA6Bf"}

package/dist/schema/rate-limits.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * Drizzle schema and database initialization for rate limit tracking.
+ *
+ * Provides:
+ * - createRateLimitCountersTable: Factory for Drizzle table with custom schema
+ * - initRateLimitTable: SQL initialization for the table
+ * - Default rateLimitCounters table for public schema
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rateLimitCounters = void 0;
+exports.createRateLimitCountersTable = createRateLimitCountersTable;
+exports.createRateLimitCountersTablePublic = createRateLimitCountersTablePublic;
+exports.initRateLimitTable = initRateLimitTable;
+const pg_core_1 = require("drizzle-orm/pg-core");
+/**
+ * Create a rate limit counters table for a specific PostgreSQL schema.
+ *
+ * @param schema - The Drizzle pgSchema object (e.g., pgSchema("shapeshyft"))
+ * @param indexPrefix - Prefix for index names to avoid conflicts
+ * @returns Drizzle table definition
+ *
+ * @example
+ * ```typescript
+ * import { pgSchema } from "drizzle-orm/pg-core";
+ * import { createRateLimitCountersTable } from "@sudobility/ratelimit_service";
+ *
+ * const mySchema = pgSchema("myapp");
+ * export const rateLimitCounters = createRateLimitCountersTable(mySchema, "myapp");
+ * ```
+ */
+function createRateLimitCountersTable(schema, indexPrefix) {
+    return schema.table("rate_limit_counters", {
+        id: (0, pg_core_1.uuid)("id").primaryKey().defaultRandom(),
+        user_id: (0, pg_core_1.varchar)("user_id", { length: 128 }).notNull(),
+        period_type: (0, pg_core_1.varchar)("period_type", { length: 16 }).notNull(),
+        period_start: (0, pg_core_1.timestamp)("period_start", { withTimezone: true }).notNull(),
+        request_count: (0, pg_core_1.integer)("request_count").notNull().default(0),
+        created_at: (0, pg_core_1.timestamp)("created_at", { withTimezone: true }).defaultNow(),
+        updated_at: (0, pg_core_1.timestamp)("updated_at", { withTimezone: true }).defaultNow(),
+    }, (table) => ({
+        userPeriodUniqueIdx: (0, pg_core_1.uniqueIndex)(`${indexPrefix}_rate_limit_user_period_idx`).on(table.user_id, table.period_type, table.period_start),
+        userTypeIdx: (0, pg_core_1.index)(`${indexPrefix}_rate_limit_user_type_idx`).on(table.user_id, table.period_type),
+    }));
+}
+/**
+ * Create a rate limit counters table for the public schema.
+ *
+ * @param indexPrefix - Prefix for index names
+ * @returns Drizzle table definition
+ *
+ * @example
+ * ```typescript
+ * import { createRateLimitCountersTablePublic } from "@sudobility/ratelimit_service";
+ *
+ * export const rateLimitCounters = createRateLimitCountersTablePublic("sudojo");
+ * ```
+ */
+function createRateLimitCountersTablePublic(indexPrefix) {
+    return (0, pg_core_1.pgTable)("rate_limit_counters", {
+        id: (0, pg_core_1.uuid)("id").primaryKey().defaultRandom(),
+        user_id: (0, pg_core_1.varchar)("user_id", { length: 128 }).notNull(),
+        period_type: (0, pg_core_1.varchar)("period_type", { length: 16 }).notNull(),
+        period_start: (0, pg_core_1.timestamp)("period_start", { withTimezone: true }).notNull(),
+        request_count: (0, pg_core_1.integer)("request_count").notNull().default(0),
+        created_at: (0, pg_core_1.timestamp)("created_at", { withTimezone: true }).defaultNow(),
+        updated_at: (0, pg_core_1.timestamp)("updated_at", { withTimezone: true }).defaultNow(),
+    }, table => ({
+        userPeriodUniqueIdx: (0, pg_core_1.uniqueIndex)(`${indexPrefix}_rate_limit_user_period_idx`).on(table.user_id, table.period_type, table.period_start),
+        userTypeIdx: (0, pg_core_1.index)(`${indexPrefix}_rate_limit_user_type_idx`).on(table.user_id, table.period_type),
+    }));
+}
+/**
+ * Default rate limit counters table for public schema.
+ * Use createRateLimitCountersTable for custom schemas.
+ */
+exports.rateLimitCounters = (0, pg_core_1.pgTable)("rate_limit_counters", {
+    id: (0, pg_core_1.uuid)("id").primaryKey().defaultRandom(),
+    user_id: (0, pg_core_1.varchar)("user_id", { length: 128 }).notNull(),
+    period_type: (0, pg_core_1.varchar)("period_type", { length: 16 }).notNull(),
+    period_start: (0, pg_core_1.timestamp)("period_start", { withTimezone: true }).notNull(),
+    request_count: (0, pg_core_1.integer)("request_count").notNull().default(0),
+    created_at: (0, pg_core_1.timestamp)("created_at", { withTimezone: true }).defaultNow(),
+    updated_at: (0, pg_core_1.timestamp)("updated_at", { withTimezone: true }).defaultNow(),
+}, table => ({
+    userPeriodUniqueIdx: (0, pg_core_1.uniqueIndex)("rate_limit_counters_user_period_idx").on(table.user_id, table.period_type, table.period_start),
+    userTypeIdx: (0, pg_core_1.index)("rate_limit_counters_user_type_idx").on(table.user_id, table.period_type),
+}));
+/**
+ * Initialize the rate limit counters table in the database.
+ *
+ * @param client - postgres-js client instance
+ * @param schemaName - PostgreSQL schema name (e.g., "shapeshyft", "whisperly", or null for public)
+ * @param indexPrefix - Prefix for index names to avoid conflicts
+ *
+ * @example
+ * ```typescript
+ * import postgres from "postgres";
+ * import { initRateLimitTable } from "@sudobility/ratelimit_service";
+ *
+ * const client = postgres(connectionString);
+ *
+ * // For public schema
+ * await initRateLimitTable(client, null, "sudojo");
+ *
+ * // For custom schema
+ * await initRateLimitTable(client, "shapeshyft", "shapeshyft");
+ * ```
+ */
+async function initRateLimitTable(client, schemaName, indexPrefix) {
+    const tableName = schemaName
+        ? `${schemaName}.rate_limit_counters`
+        : "rate_limit_counters";
+    const uniqueIdxName = `${indexPrefix}_rate_limit_user_period_idx`;
+    const typeIdxName = `${indexPrefix}_rate_limit_user_type_idx`;
+    await client.unsafe(`
+    CREATE TABLE IF NOT EXISTS ${tableName} (
+      id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+      user_id VARCHAR(128) NOT NULL,
+      period_type VARCHAR(16) NOT NULL,
+      period_start TIMESTAMPTZ NOT NULL,
+      request_count INTEGER NOT NULL DEFAULT 0,
+      created_at TIMESTAMPTZ DEFAULT NOW(),
+      updated_at TIMESTAMPTZ DEFAULT NOW()
+    )
+  `);
+    await client.unsafe(`
+    CREATE UNIQUE INDEX IF NOT EXISTS ${uniqueIdxName}
+    ON ${tableName} (user_id, period_type, period_start)
+  `);
+    await client.unsafe(`
+    CREATE INDEX IF NOT EXISTS ${typeIdxName}
+    ON ${tableName} (user_id, period_type)
+  `);
+}
+//# sourceMappingURL=rate-limits.js.map

package/dist/schema/rate-limits.js.map

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

package/dist/types/entitlements.cjs

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NONE_ENTITLEMENT = void 0;
+/**
+ * The special entitlement name for users without any subscription.
+ * This is returned when a user has no active entitlements in RevenueCat.
+ */
+exports.NONE_ENTITLEMENT = "none";
+//# sourceMappingURL=entitlements.js.map

package/dist/types/entitlements.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The special entitlement name for users without any subscription.
+ * This is returned when a user has no active entitlements in RevenueCat.
+ */
+export declare const NONE_ENTITLEMENT: "none";
+/**
+ * RevenueCat entitlement information from the subscriber API.
+ */
+export interface RevenueCatEntitlement {
+    /** Expiration date in ISO format, or null if lifetime */
+    expires_date: string | null;
+    /** Grace period expiration date */
+    grace_period_expires_date: string | null;
+    /** Product identifier in the app store */
+    product_identifier: string;
+    /** Purchase date in ISO format */
+    purchase_date: string;
+}
+/**
+ * Response shape from RevenueCat's GET /subscribers/{user_id} endpoint.
+ */
+export interface RevenueCatSubscriberResponse {
+    subscriber: {
+        entitlements: {
+            [key: string]: RevenueCatEntitlement;
+        };
+    };
+}
+//# sourceMappingURL=entitlements.d.ts.map

package/dist/types/entitlements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlements.d.ts","sourceRoot":"","sources":["../../src/types/entitlements.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAG,MAAe,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,yDAAyD;IACzD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mCAAmC;IACnC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,0CAA0C;IAC1C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE;QACV,YAAY,EAAE;YACZ,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAAC;SACtC,CAAC;KACH,CAAC;CACH"}

package/dist/types/entitlements.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NONE_ENTITLEMENT = void 0;
+/**
+ * The special entitlement name for users without any subscription.
+ * This is returned when a user has no active entitlements in RevenueCat.
+ */
+exports.NONE_ENTITLEMENT = "none";
+//# sourceMappingURL=entitlements.js.map

package/dist/types/entitlements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entitlements.js","sourceRoot":"","sources":["../../src/types/entitlements.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,gBAAgB,GAAG,MAAe,CAAC"}

package/dist/types/index.cjs

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./rate-limits"), exports);
+__exportStar(require("./entitlements"), exports);
+__exportStar(require("./responses"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./rate-limits";
+export * from "./entitlements";
+export * from "./responses";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./rate-limits"), exports);
+__exportStar(require("./entitlements"), exports);
+__exportStar(require("./responses"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,iDAA+B;AAC/B,8CAA4B"}

package/dist/types/rate-limits.cjs

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=rate-limits.js.map

package/dist/types/rate-limits.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Rate limits for a single time period.
+ * undefined means unlimited for that period.
+ */
+export interface RateLimits {
+    /** Requests allowed per hour. undefined = unlimited */
+    hourly?: number;
+    /** Requests allowed per day. undefined = unlimited */
+    daily?: number;
+    /** Requests allowed per month. undefined = unlimited */
+    monthly?: number;
+}
+/**
+ * Configuration mapping entitlement names to their rate limits.
+ * The key "none" is required and applies to users without any subscription.
+ *
+ * @example
+ * ```typescript
+ * const config: RateLimitsConfig = {
+ *   none: { hourly: 2, daily: 5, monthly: 20 },
+ *   starter: { hourly: 10, daily: 50, monthly: 500 },
+ *   pro: { hourly: 100, daily: undefined, monthly: undefined },
+ *   enterprise: { hourly: undefined, daily: undefined, monthly: undefined },
+ * };
+ * ```
+ */
+export type RateLimitsConfig = {
+    /** Rate limits for users without any entitlement (required) */
+    none: RateLimits;
+} & {
+    /** Rate limits for each entitlement name */
+    [entitlement: string]: RateLimits;
+};
+//# sourceMappingURL=rate-limits.d.ts.map

package/dist/types/rate-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limits.d.ts","sourceRoot":"","sources":["../../src/types/rate-limits.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,+DAA+D;IAC/D,IAAI,EAAE,UAAU,CAAC;CAClB,GAAG;IACF,4CAA4C;IAC5C,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC;CACnC,CAAC"}

package/dist/types/rate-limits.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=rate-limits.js.map

package/dist/types/rate-limits.js.map

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

package/dist/types/responses.cjs

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PeriodType = void 0;
+/**
+ * Valid period types for rate limiting.
+ */
+var PeriodType;
+(function (PeriodType) {
+    PeriodType["HOURLY"] = "hourly";
+    PeriodType["DAILY"] = "daily";
+    PeriodType["MONTHLY"] = "monthly";
+})(PeriodType || (exports.PeriodType = PeriodType = {}));
+//# sourceMappingURL=responses.js.map