@mycreat-labs/integrations-sdk 0.0.0-stage → 0.1.1

package/dist/adapters/redis.js

@@ -0,0 +1,98 @@
+// src/adapters/redis.ts
+import { randomUUID } from "crypto";
+
+// src/errors.ts
+var IntegrationError = class extends Error {
+  constructor(code, disposition = "permanent_failure", retryAfterMs) {
+    super(code);
+    this.code = code;
+    this.disposition = disposition;
+    this.retryAfterMs = retryAfterMs;
+    this.name = "IntegrationError";
+  }
+  code;
+  disposition;
+  retryAfterMs;
+  sdkError = "@mycreat-labs/integrations-sdk/v1";
+};
+
+// src/adapters/redis.ts
+function createRedisOneTimeStore(redis, prefix) {
+  if (!/^[a-zA-Z0-9:_-]{1,128}$/.test(prefix))
+    throw new IntegrationError("invalid_redis_prefix");
+  return {
+    async put(id, value, ttlMs) {
+      if (!Number.isInteger(ttlMs) || ttlMs < 1 || ttlMs > 6e5)
+        throw new IntegrationError("invalid_expiry");
+      const inserted = await redis.set(
+        `${prefix}:once:${id}`,
+        value,
+        "PX",
+        ttlMs,
+        "NX"
+      );
+      if (inserted !== "OK") throw new IntegrationError("one_time_conflict");
+    },
+    async consume(id) {
+      return await redis.eval(
+        "local v=redis.call('GET',KEYS[1]); if v then redis.call('DEL',KEYS[1]); end; return v",
+        1,
+        `${prefix}:once:${id}`
+      );
+    }
+  };
+}
+function createRedisLease(redis, prefix) {
+  if (!/^[a-zA-Z0-9:_-]{1,128}$/.test(prefix))
+    throw new IntegrationError("invalid_redis_prefix");
+  return {
+    async acquire(key, ttlMs) {
+      if (!Number.isInteger(ttlMs) || ttlMs < 1)
+        throw new IntegrationError("invalid_expiry");
+      const token = randomUUID();
+      return await redis.set(
+        `${prefix}:lease:${key}`,
+        token,
+        "PX",
+        ttlMs,
+        "NX"
+      ) === "OK" ? token : null;
+    },
+    async release(key, token) {
+      return Number(
+        await redis.eval(
+          "if redis.call('GET',KEYS[1])==ARGV[1] then return redis.call('DEL',KEYS[1]); end; return 0",
+          1,
+          `${prefix}:lease:${key}`,
+          token
+        )
+      ) === 1;
+    }
+  };
+}
+function createRedisRateLimiter(redis, options) {
+  if (!/^[a-zA-Z0-9:_-]{1,128}$/.test(options.prefix) || !Number.isInteger(options.limit) || options.limit < 1 || !Number.isInteger(options.windowMs) || options.windowMs < 1)
+    throw new IntegrationError("invalid_rate_limit");
+  return {
+    async take(key) {
+      const result = await redis.eval(
+        "local n=redis.call('INCR',KEYS[1]); if n==1 then redis.call('PEXPIRE',KEYS[1],ARGV[1]); end; return {n,redis.call('PTTL',KEYS[1])}",
+        1,
+        `${options.prefix}:rate:${key}`,
+        options.windowMs
+      );
+      if (!Array.isArray(result) || result.length !== 2 || !Number.isInteger(Number(result[0])) || Number(result[0]) < 1 || !Number.isFinite(Number(result[1])) || Number(result[1]) < 0)
+        throw new IntegrationError("rate_limit_unavailable", "retryable", 1e3);
+      return {
+        allowed: Number(result[0]) <= options.limit,
+        retryAfterMs: Math.max(1, Number(result[1]))
+      };
+    }
+  };
+}
+export {
+  createRedisLease,
+  createRedisOneTimeStore,
+  createRedisRateLimiter
+};
+//# sourceMappingURL=redis.js.map

package/dist/adapters/redis.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/redis.ts","../../src/errors.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type Redis from \"ioredis\";\nimport { IntegrationError } from \"../errors\";\nimport type { ApiRateLimiter } from \"../types\";\n\n/** Atomic one-shot values for product-native handoffs; namespace every product/environment. */\nexport function createRedisOneTimeStore(\n  redis: Pick<Redis, \"set\" | \"eval\">,\n  prefix: string,\n) {\n  if (!/^[a-zA-Z0-9:_-]{1,128}$/.test(prefix))\n    throw new IntegrationError(\"invalid_redis_prefix\");\n  return {\n    async put(id: string, value: string, ttlMs: number) {\n      if (!Number.isInteger(ttlMs) || ttlMs < 1 || ttlMs > 600_000)\n        throw new IntegrationError(\"invalid_expiry\");\n      const inserted = await redis.set(\n        `${prefix}:once:${id}`,\n        value,\n        \"PX\",\n        ttlMs,\n        \"NX\",\n      );\n      if (inserted !== \"OK\") throw new IntegrationError(\"one_time_conflict\");\n    },\n    async consume(id: string) {\n      return (await redis.eval(\n        \"local v=redis.call('GET',KEYS[1]); if v then redis.call('DEL',KEYS[1]); end; return v\",\n        1,\n        `${prefix}:once:${id}`,\n      )) as string | null;\n    },\n  };\n}\nexport function createRedisLease(\n  redis: Pick<Redis, \"set\" | \"eval\">,\n  prefix: string,\n) {\n  if (!/^[a-zA-Z0-9:_-]{1,128}$/.test(prefix))\n    throw new IntegrationError(\"invalid_redis_prefix\");\n  return {\n    async acquire(key: string, ttlMs: number) {\n      if (!Number.isInteger(ttlMs) || ttlMs < 1)\n        throw new IntegrationError(\"invalid_expiry\");\n      const token = randomUUID();\n      return (await redis.set(\n        `${prefix}:lease:${key}`,\n        token,\n        \"PX\",\n        ttlMs,\n        \"NX\",\n      )) === \"OK\"\n        ? token\n        : null;\n    },\n    async release(key: string, token: string) {\n      return (\n        Number(\n          await redis.eval(\n            \"if redis.call('GET',KEYS[1])==ARGV[1] then return redis.call('DEL',KEYS[1]); end; return 0\",\n            1,\n            `${prefix}:lease:${key}`,\n            token,\n          ),\n        ) === 1\n      );\n    },\n  };\n}\n/** Atomic fixed-window admission shared by the product's API and Worker processes. */\nexport function createRedisRateLimiter(\n  redis: Pick<Redis, \"eval\">,\n  options: { prefix: string; limit: number; windowMs: number },\n): ApiRateLimiter {\n  if (\n    !/^[a-zA-Z0-9:_-]{1,128}$/.test(options.prefix) ||\n    !Number.isInteger(options.limit) ||\n    options.limit < 1 ||\n    !Number.isInteger(options.windowMs) ||\n    options.windowMs < 1\n  )\n    throw new IntegrationError(\"invalid_rate_limit\");\n  return {\n    async take(key) {\n      const result = (await redis.eval(\n        \"local n=redis.call('INCR',KEYS[1]); if n==1 then redis.call('PEXPIRE',KEYS[1],ARGV[1]); end; return {n,redis.call('PTTL',KEYS[1])}\",\n        1,\n        `${options.prefix}:rate:${key}`,\n        options.windowMs,\n      )) as unknown;\n      if (\n        !Array.isArray(result) ||\n        result.length !== 2 ||\n        !Number.isInteger(Number(result[0])) ||\n        Number(result[0]) < 1 ||\n        !Number.isFinite(Number(result[1])) ||\n        Number(result[1]) < 0\n      )\n        throw new IntegrationError(\"rate_limit_unavailable\", \"retryable\", 1000);\n      return {\n        allowed: Number(result[0]) <= options.limit,\n        retryAfterMs: Math.max(1, Number(result[1])),\n      };\n    },\n  };\n}\n","export type FailureDisposition =\n  \"retryable\" | \"requires_reauth\" | \"outcome_unknown\" | \"permanent_failure\";\nexport class IntegrationError extends Error {\n  readonly sdkError = \"@mycreat-labs/integrations-sdk/v1\";\n  constructor(\n    readonly code: string,\n    readonly disposition: FailureDisposition = \"permanent_failure\",\n    readonly retryAfterMs?: number,\n  ) {\n    super(code);\n    this.name = \"IntegrationError\";\n  }\n}\nexport function integrationError(error: unknown): IntegrationError {\n  if (error instanceof IntegrationError) return error;\n  // Bundled subpath entries and independently installed copies have separate class identities.\n  if (\n    error instanceof Error &&\n    \"sdkError\" in error &&\n    error.sdkError === \"@mycreat-labs/integrations-sdk/v1\" &&\n    \"code\" in error &&\n    typeof error.code === \"string\" &&\n    /^[a-zA-Z0-9_]{1,100}$/.test(error.code) &&\n    \"disposition\" in error &&\n    [\n      \"retryable\",\n      \"requires_reauth\",\n      \"outcome_unknown\",\n      \"permanent_failure\",\n    ].includes(String(error.disposition))\n  ) {\n    const delay =\n      \"retryAfterMs\" in error &&\n      typeof error.retryAfterMs === \"number\" &&\n      Number.isFinite(error.retryAfterMs) &&\n      error.retryAfterMs >= 0\n        ? error.retryAfterMs\n        : undefined;\n    return new IntegrationError(\n      error.code,\n      error.disposition as FailureDisposition,\n      delay,\n    );\n  }\n  return new IntegrationError(\"provider_unavailable\", \"outcome_unknown\");\n}\n"],"mappings":";AAAA,SAAS,kBAAkB;;;ACEpB,IAAM,mBAAN,cAA+B,MAAM;AAAA,EAE1C,YACW,MACA,cAAkC,qBAClC,cACT;AACA,UAAM,IAAI;AAJD;AACA;AACA;AAGT,SAAK,OAAO;AAAA,EACd;AAAA,EANW;AAAA,EACA;AAAA,EACA;AAAA,EAJF,WAAW;AAStB;;;ADNO,SAAS,wBACd,OACA,QACA;AACA,MAAI,CAAC,0BAA0B,KAAK,MAAM;AACxC,UAAM,IAAI,iBAAiB,sBAAsB;AACnD,SAAO;AAAA,IACL,MAAM,IAAI,IAAY,OAAe,OAAe;AAClD,UAAI,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,KAAK,QAAQ;AACnD,cAAM,IAAI,iBAAiB,gBAAgB;AAC7C,YAAM,WAAW,MAAM,MAAM;AAAA,QAC3B,GAAG,MAAM,SAAS,EAAE;AAAA,QACpB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AACA,UAAI,aAAa,KAAM,OAAM,IAAI,iBAAiB,mBAAmB;AAAA,IACvE;AAAA,IACA,MAAM,QAAQ,IAAY;AACxB,aAAQ,MAAM,MAAM;AAAA,QAClB;AAAA,QACA;AAAA,QACA,GAAG,MAAM,SAAS,EAAE;AAAA,MACtB;AAAA,IACF;AAAA,EACF;AACF;AACO,SAAS,iBACd,OACA,QACA;AACA,MAAI,CAAC,0BAA0B,KAAK,MAAM;AACxC,UAAM,IAAI,iBAAiB,sBAAsB;AACnD,SAAO;AAAA,IACL,MAAM,QAAQ,KAAa,OAAe;AACxC,UAAI,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ;AACtC,cAAM,IAAI,iBAAiB,gBAAgB;AAC7C,YAAM,QAAQ,WAAW;AACzB,aAAQ,MAAM,MAAM;AAAA,QAClB,GAAG,MAAM,UAAU,GAAG;AAAA,QACtB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,MAAO,OACH,QACA;AAAA,IACN;AAAA,IACA,MAAM,QAAQ,KAAa,OAAe;AACxC,aACE;AAAA,QACE,MAAM,MAAM;AAAA,UACV;AAAA,UACA;AAAA,UACA,GAAG,MAAM,UAAU,GAAG;AAAA,UACtB;AAAA,QACF;AAAA,MACF,MAAM;AAAA,IAEV;AAAA,EACF;AACF;AAEO,SAAS,uBACd,OACA,SACgB;AAChB,MACE,CAAC,0BAA0B,KAAK,QAAQ,MAAM,KAC9C,CAAC,OAAO,UAAU,QAAQ,KAAK,KAC/B,QAAQ,QAAQ,KAChB,CAAC,OAAO,UAAU,QAAQ,QAAQ,KAClC,QAAQ,WAAW;AAEnB,UAAM,IAAI,iBAAiB,oBAAoB;AACjD,SAAO;AAAA,IACL,MAAM,KAAK,KAAK;AACd,YAAM,SAAU,MAAM,MAAM;AAAA,QAC1B;AAAA,QACA;AAAA,QACA,GAAG,QAAQ,MAAM,SAAS,GAAG;AAAA,QAC7B,QAAQ;AAAA,MACV;AACA,UACE,CAAC,MAAM,QAAQ,MAAM,KACrB,OAAO,WAAW,KAClB,CAAC,OAAO,UAAU,OAAO,OAAO,CAAC,CAAC,CAAC,KACnC,OAAO,OAAO,CAAC,CAAC,IAAI,KACpB,CAAC,OAAO,SAAS,OAAO,OAAO,CAAC,CAAC,CAAC,KAClC,OAAO,OAAO,CAAC,CAAC,IAAI;AAEpB,cAAM,IAAI,iBAAiB,0BAA0B,aAAa,GAAI;AACxE,aAAO;AAAA,QACL,SAAS,OAAO,OAAO,CAAC,CAAC,KAAK,QAAQ;AAAA,QACtC,cAAc,KAAK,IAAI,GAAG,OAAO,OAAO,CAAC,CAAC,CAAC;AAAA,MAC7C;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/errors-3hDEtzuZ.d.cts

@@ -0,0 +1,11 @@
+type FailureDisposition = "retryable" | "requires_reauth" | "outcome_unknown" | "permanent_failure";
+declare class IntegrationError extends Error {
+    readonly code: string;
+    readonly disposition: FailureDisposition;
+    readonly retryAfterMs?: number | undefined;
+    readonly sdkError = "@mycreat-labs/integrations-sdk/v1";
+    constructor(code: string, disposition?: FailureDisposition, retryAfterMs?: number | undefined);
+}
+declare function integrationError(error: unknown): IntegrationError;
+
+export { type FailureDisposition as F, IntegrationError as I, integrationError as i };

package/dist/errors-3hDEtzuZ.d.ts

@@ -0,0 +1,11 @@
+type FailureDisposition = "retryable" | "requires_reauth" | "outcome_unknown" | "permanent_failure";
+declare class IntegrationError extends Error {
+    readonly code: string;
+    readonly disposition: FailureDisposition;
+    readonly retryAfterMs?: number | undefined;
+    readonly sdkError = "@mycreat-labs/integrations-sdk/v1";
+    constructor(code: string, disposition?: FailureDisposition, retryAfterMs?: number | undefined);
+}
+declare function integrationError(error: unknown): IntegrationError;
+
+export { type FailureDisposition as F, IntegrationError as I, integrationError as i };