@celerity-sdk/common 0.3.1 → 0.4.0

package/dist/index.cjs

@@ -21,8 +21,15 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  CONFIG_SERVICE_TOKEN: () => CONFIG_SERVICE_TOKEN,
+  INJECT_METADATA: () => INJECT_METADATA,
+  LOGGER_TOKEN: () => LOGGER_TOKEN,
+  TRACER_TOKEN: () => TRACER_TOKEN,
+  USE_RESOURCE_METADATA: () => USE_RESOURCE_METADATA,
   extractUserId: () => extractUserId,
-  joinHandlerPath: () => joinHandlerPath
+  joinHandlerPath: () => joinHandlerPath,
+  mapBucketEventType: () => mapBucketEventType,
+  mapDatastoreEventType: () => mapDatastoreEventType
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -55,9 +62,52 @@ function joinHandlerPath(prefix, methodPath) {
   return path;
 }
 __name(joinHandlerPath, "joinHandlerPath");
+
+// src/tokens.ts
+var LOGGER_TOKEN = "CelerityLogger";
+var TRACER_TOKEN = "CelerityTracer";
+var CONFIG_SERVICE_TOKEN = "ConfigService";
+var INJECT_METADATA = /* @__PURE__ */ Symbol.for("celerity:inject");
+var USE_RESOURCE_METADATA = /* @__PURE__ */ Symbol.for("celerity:useResource");
+
+// src/event-type-mapping.ts
+function mapBucketEventType(cloudEventName) {
+  const name = cloudEventName.startsWith("s3:") ? cloudEventName.slice(3) : cloudEventName;
+  if (name.startsWith("ObjectCreated:") || name.startsWith("ObjectRestore:")) {
+    return "created";
+  }
+  if (name.startsWith("ObjectRemoved:")) {
+    return "deleted";
+  }
+  if (name.startsWith("ObjectTagging:") || name.startsWith("ObjectAcl:")) {
+    return "metadataUpdated";
+  }
+  return void 0;
+}
+__name(mapBucketEventType, "mapBucketEventType");
+function mapDatastoreEventType(cloudEventName) {
+  switch (cloudEventName) {
+    case "INSERT":
+      return "inserted";
+    case "MODIFY":
+      return "modified";
+    case "REMOVE":
+      return "removed";
+    default:
+      return void 0;
+  }
+}
+__name(mapDatastoreEventType, "mapDatastoreEventType");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  CONFIG_SERVICE_TOKEN,
+  INJECT_METADATA,
+  LOGGER_TOKEN,
+  TRACER_TOKEN,
+  USE_RESOURCE_METADATA,
   extractUserId,
-  joinHandlerPath
+  joinHandlerPath,
+  mapBucketEventType,
+  mapDatastoreEventType
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/auth.ts","../src/path.ts"],"sourcesContent":["export { extractUserId } from \"./auth\";\nexport { joinHandlerPath } from \"./path\";\n","/**\n * Extract a user identifier from the auth context.\n *\n * Auth context is a guard-name-keyed map, e.g.:\n *   { jwt: { claims: { sub: \"user-42\", ... } }, customGuard: { userId: \"104932\" } }\n *\n * Walks all guard results looking for the first string match in priority order:\n *   1. claims.sub  (standard JWT — jwt guard wraps claims in a \"claims\" key)\n *   2. sub         (custom guard returning standard OIDC claims directly)\n *   3. userId      (common custom guard convention)\n *   4. user_id     (snake_case variant)\n */\nexport function extractUserId(auth: Record<string, unknown> | null): string | undefined {\n  if (!auth) return undefined;\n\n  for (const guardResult of Object.values(auth)) {\n    if (typeof guardResult !== \"object\" || guardResult === null) continue;\n    const g = guardResult as Record<string, unknown>;\n\n    // JWT guard: { claims: { sub: \"...\" } }\n    if (typeof g.claims === \"object\" && g.claims !== null) {\n      const claims = g.claims as Record<string, unknown>;\n      if (isStringOrNumber(claims.sub)) return String(claims.sub);\n    }\n\n    // Direct sub / userId / user_id on the guard result\n    if (isStringOrNumber(g.sub)) return String(g.sub);\n    if (isStringOrNumber(g.userId)) return String(g.userId);\n    if (isStringOrNumber(g.user_id)) return String(g.user_id);\n  }\n\n  return undefined;\n}\n\nfunction isStringOrNumber(value: unknown): value is string | number {\n  return typeof value === \"string\" || typeof value === \"number\";\n}\n","/**\n * Joins a handler class prefix with a method-level path.\n * Both use the `{param}` format (matching blueprints).\n *\n * @example\n * joinHandlerPath(\"/orders\", \"/{orderId}\") => \"/orders/{orderId}\"\n * joinHandlerPath(\"/\", \"/health\") => \"/health\"\n * joinHandlerPath(\"/api/v1\", \"/users\") => \"/api/v1/users\"\n */\nexport function joinHandlerPath(prefix: string, methodPath: string): string {\n  const base = prefix || \"\";\n  const path = `/${base}/${methodPath}`.replaceAll(/\\/+/g, \"/\").replace(/\\/$/, \"\") || \"/\";\n  return path;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;ACYO,SAASA,cAAcC,MAAoC;AAChE,MAAI,CAACA,KAAM,QAAOC;AAElB,aAAWC,eAAeC,OAAOC,OAAOJ,IAAAA,GAAO;AAC7C,QAAI,OAAOE,gBAAgB,YAAYA,gBAAgB,KAAM;AAC7D,UAAMG,IAAIH;AAGV,QAAI,OAAOG,EAAEC,WAAW,YAAYD,EAAEC,WAAW,MAAM;AACrD,YAAMA,SAASD,EAAEC;AACjB,UAAIC,iBAAiBD,OAAOE,GAAG,EAAG,QAAOC,OAAOH,OAAOE,GAAG;IAC5D;AAGA,QAAID,iBAAiBF,EAAEG,GAAG,EAAG,QAAOC,OAAOJ,EAAEG,GAAG;AAChD,QAAID,iBAAiBF,EAAEK,MAAM,EAAG,QAAOD,OAAOJ,EAAEK,MAAM;AACtD,QAAIH,iBAAiBF,EAAEM,OAAO,EAAG,QAAOF,OAAOJ,EAAEM,OAAO;EAC1D;AAEA,SAAOV;AACT;AApBgBF;AAsBhB,SAASQ,iBAAiBK,OAAc;AACtC,SAAO,OAAOA,UAAU,YAAY,OAAOA,UAAU;AACvD;AAFSL;;;ACzBF,SAASM,gBAAgBC,QAAgBC,YAAkB;AAChE,QAAMC,OAAOF,UAAU;AACvB,QAAMG,OAAO,IAAID,IAAAA,IAAQD,UAAAA,GAAaG,WAAW,QAAQ,GAAA,EAAKC,QAAQ,OAAO,EAAA,KAAO;AACpF,SAAOF;AACT;AAJgBJ;","names":["extractUserId","auth","undefined","guardResult","Object","values","g","claims","isStringOrNumber","sub","String","userId","user_id","value","joinHandlerPath","prefix","methodPath","base","path","replaceAll","replace"]}
+{"version":3,"sources":["../src/index.ts","../src/auth.ts","../src/path.ts","../src/tokens.ts","../src/event-type-mapping.ts"],"sourcesContent":["export { extractUserId } from \"./auth\";\nexport { joinHandlerPath } from \"./path\";\nexport {\n  LOGGER_TOKEN,\n  TRACER_TOKEN,\n  CONFIG_SERVICE_TOKEN,\n  INJECT_METADATA,\n  USE_RESOURCE_METADATA,\n} from \"./tokens\";\nexport { mapBucketEventType, mapDatastoreEventType } from \"./event-type-mapping\";\n","/**\n * Extract a user identifier from the auth context.\n *\n * Auth context is a guard-name-keyed map, e.g.:\n *   { jwt: { claims: { sub: \"user-42\", ... } }, customGuard: { userId: \"104932\" } }\n *\n * Walks all guard results looking for the first string match in priority order:\n *   1. claims.sub  (standard JWT — jwt guard wraps claims in a \"claims\" key)\n *   2. sub         (custom guard returning standard OIDC claims directly)\n *   3. userId      (common custom guard convention)\n *   4. user_id     (snake_case variant)\n */\nexport function extractUserId(auth: Record<string, unknown> | null): string | undefined {\n  if (!auth) return undefined;\n\n  for (const guardResult of Object.values(auth)) {\n    if (typeof guardResult !== \"object\" || guardResult === null) continue;\n    const g = guardResult as Record<string, unknown>;\n\n    // JWT guard: { claims: { sub: \"...\" } }\n    if (typeof g.claims === \"object\" && g.claims !== null) {\n      const claims = g.claims as Record<string, unknown>;\n      if (isStringOrNumber(claims.sub)) return String(claims.sub);\n    }\n\n    // Direct sub / userId / user_id on the guard result\n    if (isStringOrNumber(g.sub)) return String(g.sub);\n    if (isStringOrNumber(g.userId)) return String(g.userId);\n    if (isStringOrNumber(g.user_id)) return String(g.user_id);\n  }\n\n  return undefined;\n}\n\nfunction isStringOrNumber(value: unknown): value is string | number {\n  return typeof value === \"string\" || typeof value === \"number\";\n}\n","/**\n * Joins a handler class prefix with a method-level path.\n * Both use the `{param}` format (matching blueprints).\n *\n * @example\n * joinHandlerPath(\"/orders\", \"/{orderId}\") => \"/orders/{orderId}\"\n * joinHandlerPath(\"/\", \"/health\") => \"/health\"\n * joinHandlerPath(\"/api/v1\", \"/users\") => \"/api/v1/users\"\n */\nexport function joinHandlerPath(prefix: string, methodPath: string): string {\n  const base = prefix || \"\";\n  const path = `/${base}/${methodPath}`.replaceAll(/\\/+/g, \"/\").replace(/\\/$/, \"\") || \"/\";\n  return path;\n}\n","// -- DI service tokens (string constants for container registration) --\n\n/** DI token for the CelerityLogger service. */\nexport const LOGGER_TOKEN = \"CelerityLogger\";\n\n/** DI token for the CelerityTracer service. */\nexport const TRACER_TOKEN = \"CelerityTracer\";\n\n/** DI token for the ConfigService. */\nexport const CONFIG_SERVICE_TOKEN = \"ConfigService\";\n\n// -- Cross-package decorator metadata symbols --\n// Used by resource-type packages (bucket, queue, etc.) to write DI and\n// resource metadata without depending on @celerity-sdk/core.\n\n/** Metadata key for `@Inject()` parameter overrides. */\nexport const INJECT_METADATA = Symbol.for(\"celerity:inject\");\n\n/** Metadata key for `@UseResource()` / resource-type param decorators. */\nexport const USE_RESOURCE_METADATA = Symbol.for(\"celerity:useResource\");\n","/**\n * Maps an AWS S3 (or MinIO) event name to a Celerity-standard bucket event type.\n * Handles both the subscription format (`s3:ObjectCreated:Put`) used by\n * MinIO/runtime and the notification format (`ObjectCreated:Put`) in S3 notification JSON.\n * Returns `undefined` for unrecognised event names.\n */\nexport function mapBucketEventType(cloudEventName: string): string | undefined {\n  // Normalise: strip optional \"s3:\" prefix so both formats work\n  const name = cloudEventName.startsWith(\"s3:\") ? cloudEventName.slice(3) : cloudEventName;\n\n  if (name.startsWith(\"ObjectCreated:\") || name.startsWith(\"ObjectRestore:\")) {\n    return \"created\";\n  }\n  if (name.startsWith(\"ObjectRemoved:\")) {\n    return \"deleted\";\n  }\n  if (name.startsWith(\"ObjectTagging:\") || name.startsWith(\"ObjectAcl:\")) {\n    return \"metadataUpdated\";\n  }\n  return undefined;\n}\n\n/**\n * Maps an AWS DynamoDB Streams event name to a Celerity-standard datastore event type.\n * Returns `undefined` for unrecognised event names.\n */\nexport function mapDatastoreEventType(cloudEventName: string): string | undefined {\n  switch (cloudEventName) {\n    case \"INSERT\":\n      return \"inserted\";\n    case \"MODIFY\":\n      return \"modified\";\n    case \"REMOVE\":\n      return \"removed\";\n    default:\n      return undefined;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;ACYO,SAASA,cAAcC,MAAoC;AAChE,MAAI,CAACA,KAAM,QAAOC;AAElB,aAAWC,eAAeC,OAAOC,OAAOJ,IAAAA,GAAO;AAC7C,QAAI,OAAOE,gBAAgB,YAAYA,gBAAgB,KAAM;AAC7D,UAAMG,IAAIH;AAGV,QAAI,OAAOG,EAAEC,WAAW,YAAYD,EAAEC,WAAW,MAAM;AACrD,YAAMA,SAASD,EAAEC;AACjB,UAAIC,iBAAiBD,OAAOE,GAAG,EAAG,QAAOC,OAAOH,OAAOE,GAAG;IAC5D;AAGA,QAAID,iBAAiBF,EAAEG,GAAG,EAAG,QAAOC,OAAOJ,EAAEG,GAAG;AAChD,QAAID,iBAAiBF,EAAEK,MAAM,EAAG,QAAOD,OAAOJ,EAAEK,MAAM;AACtD,QAAIH,iBAAiBF,EAAEM,OAAO,EAAG,QAAOF,OAAOJ,EAAEM,OAAO;EAC1D;AAEA,SAAOV;AACT;AApBgBF;AAsBhB,SAASQ,iBAAiBK,OAAc;AACtC,SAAO,OAAOA,UAAU,YAAY,OAAOA,UAAU;AACvD;AAFSL;;;ACzBF,SAASM,gBAAgBC,QAAgBC,YAAkB;AAChE,QAAMC,OAAOF,UAAU;AACvB,QAAMG,OAAO,IAAID,IAAAA,IAAQD,UAAAA,GAAaG,WAAW,QAAQ,GAAA,EAAKC,QAAQ,OAAO,EAAA,KAAO;AACpF,SAAOF;AACT;AAJgBJ;;;ACNT,IAAMO,eAAe;AAGrB,IAAMC,eAAe;AAGrB,IAAMC,uBAAuB;AAO7B,IAAMC,kBAAkBC,uBAAOC,IAAI,iBAAA;AAGnC,IAAMC,wBAAwBF,uBAAOC,IAAI,sBAAA;;;ACbzC,SAASE,mBAAmBC,gBAAsB;AAEvD,QAAMC,OAAOD,eAAeE,WAAW,KAAA,IAASF,eAAeG,MAAM,CAAA,IAAKH;AAE1E,MAAIC,KAAKC,WAAW,gBAAA,KAAqBD,KAAKC,WAAW,gBAAA,GAAmB;AAC1E,WAAO;EACT;AACA,MAAID,KAAKC,WAAW,gBAAA,GAAmB;AACrC,WAAO;EACT;AACA,MAAID,KAAKC,WAAW,gBAAA,KAAqBD,KAAKC,WAAW,YAAA,GAAe;AACtE,WAAO;EACT;AACA,SAAOE;AACT;AAdgBL;AAoBT,SAASM,sBAAsBL,gBAAsB;AAC1D,UAAQA,gBAAAA;IACN,KAAK;AACH,aAAO;IACT,KAAK;AACH,aAAO;IACT,KAAK;AACH,aAAO;IACT;AACE,aAAOI;EACX;AACF;AAXgBC;","names":["extractUserId","auth","undefined","guardResult","Object","values","g","claims","isStringOrNumber","sub","String","userId","user_id","value","joinHandlerPath","prefix","methodPath","base","path","replaceAll","replace","LOGGER_TOKEN","TRACER_TOKEN","CONFIG_SERVICE_TOKEN","INJECT_METADATA","Symbol","for","USE_RESOURCE_METADATA","mapBucketEventType","cloudEventName","name","startsWith","slice","undefined","mapDatastoreEventType"]}

package/dist/index.d.cts

@@ -23,4 +23,28 @@ declare function extractUserId(auth: Record<string, unknown> | null): string | u
  */
 declare function joinHandlerPath(prefix: string, methodPath: string): string;
 
-export { extractUserId, joinHandlerPath };
+/** DI token for the CelerityLogger service. */
+declare const LOGGER_TOKEN = "CelerityLogger";
+/** DI token for the CelerityTracer service. */
+declare const TRACER_TOKEN = "CelerityTracer";
+/** DI token for the ConfigService. */
+declare const CONFIG_SERVICE_TOKEN = "ConfigService";
+/** Metadata key for `@Inject()` parameter overrides. */
+declare const INJECT_METADATA: unique symbol;
+/** Metadata key for `@UseResource()` / resource-type param decorators. */
+declare const USE_RESOURCE_METADATA: unique symbol;
+
+/**
+ * Maps an AWS S3 (or MinIO) event name to a Celerity-standard bucket event type.
+ * Handles both the subscription format (`s3:ObjectCreated:Put`) used by
+ * MinIO/runtime and the notification format (`ObjectCreated:Put`) in S3 notification JSON.
+ * Returns `undefined` for unrecognised event names.
+ */
+declare function mapBucketEventType(cloudEventName: string): string | undefined;
+/**
+ * Maps an AWS DynamoDB Streams event name to a Celerity-standard datastore event type.
+ * Returns `undefined` for unrecognised event names.
+ */
+declare function mapDatastoreEventType(cloudEventName: string): string | undefined;
+
+export { CONFIG_SERVICE_TOKEN, INJECT_METADATA, LOGGER_TOKEN, TRACER_TOKEN, USE_RESOURCE_METADATA, extractUserId, joinHandlerPath, mapBucketEventType, mapDatastoreEventType };

package/dist/index.d.ts

@@ -23,4 +23,28 @@ declare function extractUserId(auth: Record<string, unknown> | null): string | u
  */
 declare function joinHandlerPath(prefix: string, methodPath: string): string;
 
-export { extractUserId, joinHandlerPath };
+/** DI token for the CelerityLogger service. */
+declare const LOGGER_TOKEN = "CelerityLogger";
+/** DI token for the CelerityTracer service. */
+declare const TRACER_TOKEN = "CelerityTracer";
+/** DI token for the ConfigService. */
+declare const CONFIG_SERVICE_TOKEN = "ConfigService";
+/** Metadata key for `@Inject()` parameter overrides. */
+declare const INJECT_METADATA: unique symbol;
+/** Metadata key for `@UseResource()` / resource-type param decorators. */
+declare const USE_RESOURCE_METADATA: unique symbol;
+
+/**
+ * Maps an AWS S3 (or MinIO) event name to a Celerity-standard bucket event type.
+ * Handles both the subscription format (`s3:ObjectCreated:Put`) used by
+ * MinIO/runtime and the notification format (`ObjectCreated:Put`) in S3 notification JSON.
+ * Returns `undefined` for unrecognised event names.
+ */
+declare function mapBucketEventType(cloudEventName: string): string | undefined;
+/**
+ * Maps an AWS DynamoDB Streams event name to a Celerity-standard datastore event type.
+ * Returns `undefined` for unrecognised event names.
+ */
+declare function mapDatastoreEventType(cloudEventName: string): string | undefined;
+
+export { CONFIG_SERVICE_TOKEN, INJECT_METADATA, LOGGER_TOKEN, TRACER_TOKEN, USE_RESOURCE_METADATA, extractUserId, joinHandlerPath, mapBucketEventType, mapDatastoreEventType };

package/dist/index.js

@@ -30,8 +30,51 @@ function joinHandlerPath(prefix, methodPath) {
   return path;
 }
 __name(joinHandlerPath, "joinHandlerPath");
+
+// src/tokens.ts
+var LOGGER_TOKEN = "CelerityLogger";
+var TRACER_TOKEN = "CelerityTracer";
+var CONFIG_SERVICE_TOKEN = "ConfigService";
+var INJECT_METADATA = /* @__PURE__ */ Symbol.for("celerity:inject");
+var USE_RESOURCE_METADATA = /* @__PURE__ */ Symbol.for("celerity:useResource");
+
+// src/event-type-mapping.ts
+function mapBucketEventType(cloudEventName) {
+  const name = cloudEventName.startsWith("s3:") ? cloudEventName.slice(3) : cloudEventName;
+  if (name.startsWith("ObjectCreated:") || name.startsWith("ObjectRestore:")) {
+    return "created";
+  }
+  if (name.startsWith("ObjectRemoved:")) {
+    return "deleted";
+  }
+  if (name.startsWith("ObjectTagging:") || name.startsWith("ObjectAcl:")) {
+    return "metadataUpdated";
+  }
+  return void 0;
+}
+__name(mapBucketEventType, "mapBucketEventType");
+function mapDatastoreEventType(cloudEventName) {
+  switch (cloudEventName) {
+    case "INSERT":
+      return "inserted";
+    case "MODIFY":
+      return "modified";
+    case "REMOVE":
+      return "removed";
+    default:
+      return void 0;
+  }
+}
+__name(mapDatastoreEventType, "mapDatastoreEventType");
 export {
+  CONFIG_SERVICE_TOKEN,
+  INJECT_METADATA,
+  LOGGER_TOKEN,
+  TRACER_TOKEN,
+  USE_RESOURCE_METADATA,
   extractUserId,
-  joinHandlerPath
+  joinHandlerPath,
+  mapBucketEventType,
+  mapDatastoreEventType
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/auth.ts","../src/path.ts"],"sourcesContent":["/**\n * Extract a user identifier from the auth context.\n *\n * Auth context is a guard-name-keyed map, e.g.:\n *   { jwt: { claims: { sub: \"user-42\", ... } }, customGuard: { userId: \"104932\" } }\n *\n * Walks all guard results looking for the first string match in priority order:\n *   1. claims.sub  (standard JWT — jwt guard wraps claims in a \"claims\" key)\n *   2. sub         (custom guard returning standard OIDC claims directly)\n *   3. userId      (common custom guard convention)\n *   4. user_id     (snake_case variant)\n */\nexport function extractUserId(auth: Record<string, unknown> | null): string | undefined {\n  if (!auth) return undefined;\n\n  for (const guardResult of Object.values(auth)) {\n    if (typeof guardResult !== \"object\" || guardResult === null) continue;\n    const g = guardResult as Record<string, unknown>;\n\n    // JWT guard: { claims: { sub: \"...\" } }\n    if (typeof g.claims === \"object\" && g.claims !== null) {\n      const claims = g.claims as Record<string, unknown>;\n      if (isStringOrNumber(claims.sub)) return String(claims.sub);\n    }\n\n    // Direct sub / userId / user_id on the guard result\n    if (isStringOrNumber(g.sub)) return String(g.sub);\n    if (isStringOrNumber(g.userId)) return String(g.userId);\n    if (isStringOrNumber(g.user_id)) return String(g.user_id);\n  }\n\n  return undefined;\n}\n\nfunction isStringOrNumber(value: unknown): value is string | number {\n  return typeof value === \"string\" || typeof value === \"number\";\n}\n","/**\n * Joins a handler class prefix with a method-level path.\n * Both use the `{param}` format (matching blueprints).\n *\n * @example\n * joinHandlerPath(\"/orders\", \"/{orderId}\") => \"/orders/{orderId}\"\n * joinHandlerPath(\"/\", \"/health\") => \"/health\"\n * joinHandlerPath(\"/api/v1\", \"/users\") => \"/api/v1/users\"\n */\nexport function joinHandlerPath(prefix: string, methodPath: string): string {\n  const base = prefix || \"\";\n  const path = `/${base}/${methodPath}`.replaceAll(/\\/+/g, \"/\").replace(/\\/$/, \"\") || \"/\";\n  return path;\n}\n"],"mappings":";;;;AAYO,SAASA,cAAcC,MAAoC;AAChE,MAAI,CAACA,KAAM,QAAOC;AAElB,aAAWC,eAAeC,OAAOC,OAAOJ,IAAAA,GAAO;AAC7C,QAAI,OAAOE,gBAAgB,YAAYA,gBAAgB,KAAM;AAC7D,UAAMG,IAAIH;AAGV,QAAI,OAAOG,EAAEC,WAAW,YAAYD,EAAEC,WAAW,MAAM;AACrD,YAAMA,SAASD,EAAEC;AACjB,UAAIC,iBAAiBD,OAAOE,GAAG,EAAG,QAAOC,OAAOH,OAAOE,GAAG;IAC5D;AAGA,QAAID,iBAAiBF,EAAEG,GAAG,EAAG,QAAOC,OAAOJ,EAAEG,GAAG;AAChD,QAAID,iBAAiBF,EAAEK,MAAM,EAAG,QAAOD,OAAOJ,EAAEK,MAAM;AACtD,QAAIH,iBAAiBF,EAAEM,OAAO,EAAG,QAAOF,OAAOJ,EAAEM,OAAO;EAC1D;AAEA,SAAOV;AACT;AApBgBF;AAsBhB,SAASQ,iBAAiBK,OAAc;AACtC,SAAO,OAAOA,UAAU,YAAY,OAAOA,UAAU;AACvD;AAFSL;;;ACzBF,SAASM,gBAAgBC,QAAgBC,YAAkB;AAChE,QAAMC,OAAOF,UAAU;AACvB,QAAMG,OAAO,IAAID,IAAAA,IAAQD,UAAAA,GAAaG,WAAW,QAAQ,GAAA,EAAKC,QAAQ,OAAO,EAAA,KAAO;AACpF,SAAOF;AACT;AAJgBJ;","names":["extractUserId","auth","undefined","guardResult","Object","values","g","claims","isStringOrNumber","sub","String","userId","user_id","value","joinHandlerPath","prefix","methodPath","base","path","replaceAll","replace"]}
+{"version":3,"sources":["../src/auth.ts","../src/path.ts","../src/tokens.ts","../src/event-type-mapping.ts"],"sourcesContent":["/**\n * Extract a user identifier from the auth context.\n *\n * Auth context is a guard-name-keyed map, e.g.:\n *   { jwt: { claims: { sub: \"user-42\", ... } }, customGuard: { userId: \"104932\" } }\n *\n * Walks all guard results looking for the first string match in priority order:\n *   1. claims.sub  (standard JWT — jwt guard wraps claims in a \"claims\" key)\n *   2. sub         (custom guard returning standard OIDC claims directly)\n *   3. userId      (common custom guard convention)\n *   4. user_id     (snake_case variant)\n */\nexport function extractUserId(auth: Record<string, unknown> | null): string | undefined {\n  if (!auth) return undefined;\n\n  for (const guardResult of Object.values(auth)) {\n    if (typeof guardResult !== \"object\" || guardResult === null) continue;\n    const g = guardResult as Record<string, unknown>;\n\n    // JWT guard: { claims: { sub: \"...\" } }\n    if (typeof g.claims === \"object\" && g.claims !== null) {\n      const claims = g.claims as Record<string, unknown>;\n      if (isStringOrNumber(claims.sub)) return String(claims.sub);\n    }\n\n    // Direct sub / userId / user_id on the guard result\n    if (isStringOrNumber(g.sub)) return String(g.sub);\n    if (isStringOrNumber(g.userId)) return String(g.userId);\n    if (isStringOrNumber(g.user_id)) return String(g.user_id);\n  }\n\n  return undefined;\n}\n\nfunction isStringOrNumber(value: unknown): value is string | number {\n  return typeof value === \"string\" || typeof value === \"number\";\n}\n","/**\n * Joins a handler class prefix with a method-level path.\n * Both use the `{param}` format (matching blueprints).\n *\n * @example\n * joinHandlerPath(\"/orders\", \"/{orderId}\") => \"/orders/{orderId}\"\n * joinHandlerPath(\"/\", \"/health\") => \"/health\"\n * joinHandlerPath(\"/api/v1\", \"/users\") => \"/api/v1/users\"\n */\nexport function joinHandlerPath(prefix: string, methodPath: string): string {\n  const base = prefix || \"\";\n  const path = `/${base}/${methodPath}`.replaceAll(/\\/+/g, \"/\").replace(/\\/$/, \"\") || \"/\";\n  return path;\n}\n","// -- DI service tokens (string constants for container registration) --\n\n/** DI token for the CelerityLogger service. */\nexport const LOGGER_TOKEN = \"CelerityLogger\";\n\n/** DI token for the CelerityTracer service. */\nexport const TRACER_TOKEN = \"CelerityTracer\";\n\n/** DI token for the ConfigService. */\nexport const CONFIG_SERVICE_TOKEN = \"ConfigService\";\n\n// -- Cross-package decorator metadata symbols --\n// Used by resource-type packages (bucket, queue, etc.) to write DI and\n// resource metadata without depending on @celerity-sdk/core.\n\n/** Metadata key for `@Inject()` parameter overrides. */\nexport const INJECT_METADATA = Symbol.for(\"celerity:inject\");\n\n/** Metadata key for `@UseResource()` / resource-type param decorators. */\nexport const USE_RESOURCE_METADATA = Symbol.for(\"celerity:useResource\");\n","/**\n * Maps an AWS S3 (or MinIO) event name to a Celerity-standard bucket event type.\n * Handles both the subscription format (`s3:ObjectCreated:Put`) used by\n * MinIO/runtime and the notification format (`ObjectCreated:Put`) in S3 notification JSON.\n * Returns `undefined` for unrecognised event names.\n */\nexport function mapBucketEventType(cloudEventName: string): string | undefined {\n  // Normalise: strip optional \"s3:\" prefix so both formats work\n  const name = cloudEventName.startsWith(\"s3:\") ? cloudEventName.slice(3) : cloudEventName;\n\n  if (name.startsWith(\"ObjectCreated:\") || name.startsWith(\"ObjectRestore:\")) {\n    return \"created\";\n  }\n  if (name.startsWith(\"ObjectRemoved:\")) {\n    return \"deleted\";\n  }\n  if (name.startsWith(\"ObjectTagging:\") || name.startsWith(\"ObjectAcl:\")) {\n    return \"metadataUpdated\";\n  }\n  return undefined;\n}\n\n/**\n * Maps an AWS DynamoDB Streams event name to a Celerity-standard datastore event type.\n * Returns `undefined` for unrecognised event names.\n */\nexport function mapDatastoreEventType(cloudEventName: string): string | undefined {\n  switch (cloudEventName) {\n    case \"INSERT\":\n      return \"inserted\";\n    case \"MODIFY\":\n      return \"modified\";\n    case \"REMOVE\":\n      return \"removed\";\n    default:\n      return undefined;\n  }\n}\n"],"mappings":";;;;AAYO,SAASA,cAAcC,MAAoC;AAChE,MAAI,CAACA,KAAM,QAAOC;AAElB,aAAWC,eAAeC,OAAOC,OAAOJ,IAAAA,GAAO;AAC7C,QAAI,OAAOE,gBAAgB,YAAYA,gBAAgB,KAAM;AAC7D,UAAMG,IAAIH;AAGV,QAAI,OAAOG,EAAEC,WAAW,YAAYD,EAAEC,WAAW,MAAM;AACrD,YAAMA,SAASD,EAAEC;AACjB,UAAIC,iBAAiBD,OAAOE,GAAG,EAAG,QAAOC,OAAOH,OAAOE,GAAG;IAC5D;AAGA,QAAID,iBAAiBF,EAAEG,GAAG,EAAG,QAAOC,OAAOJ,EAAEG,GAAG;AAChD,QAAID,iBAAiBF,EAAEK,MAAM,EAAG,QAAOD,OAAOJ,EAAEK,MAAM;AACtD,QAAIH,iBAAiBF,EAAEM,OAAO,EAAG,QAAOF,OAAOJ,EAAEM,OAAO;EAC1D;AAEA,SAAOV;AACT;AApBgBF;AAsBhB,SAASQ,iBAAiBK,OAAc;AACtC,SAAO,OAAOA,UAAU,YAAY,OAAOA,UAAU;AACvD;AAFSL;;;ACzBF,SAASM,gBAAgBC,QAAgBC,YAAkB;AAChE,QAAMC,OAAOF,UAAU;AACvB,QAAMG,OAAO,IAAID,IAAAA,IAAQD,UAAAA,GAAaG,WAAW,QAAQ,GAAA,EAAKC,QAAQ,OAAO,EAAA,KAAO;AACpF,SAAOF;AACT;AAJgBJ;;;ACNT,IAAMO,eAAe;AAGrB,IAAMC,eAAe;AAGrB,IAAMC,uBAAuB;AAO7B,IAAMC,kBAAkBC,uBAAOC,IAAI,iBAAA;AAGnC,IAAMC,wBAAwBF,uBAAOC,IAAI,sBAAA;;;ACbzC,SAASE,mBAAmBC,gBAAsB;AAEvD,QAAMC,OAAOD,eAAeE,WAAW,KAAA,IAASF,eAAeG,MAAM,CAAA,IAAKH;AAE1E,MAAIC,KAAKC,WAAW,gBAAA,KAAqBD,KAAKC,WAAW,gBAAA,GAAmB;AAC1E,WAAO;EACT;AACA,MAAID,KAAKC,WAAW,gBAAA,GAAmB;AACrC,WAAO;EACT;AACA,MAAID,KAAKC,WAAW,gBAAA,KAAqBD,KAAKC,WAAW,YAAA,GAAe;AACtE,WAAO;EACT;AACA,SAAOE;AACT;AAdgBL;AAoBT,SAASM,sBAAsBL,gBAAsB;AAC1D,UAAQA,gBAAAA;IACN,KAAK;AACH,aAAO;IACT,KAAK;AACH,aAAO;IACT,KAAK;AACH,aAAO;IACT;AACE,aAAOI;EACX;AACF;AAXgBC;","names":["extractUserId","auth","undefined","guardResult","Object","values","g","claims","isStringOrNumber","sub","String","userId","user_id","value","joinHandlerPath","prefix","methodPath","base","path","replaceAll","replace","LOGGER_TOKEN","TRACER_TOKEN","CONFIG_SERVICE_TOKEN","INJECT_METADATA","Symbol","for","USE_RESOURCE_METADATA","mapBucketEventType","cloudEventName","name","startsWith","slice","undefined","mapDatastoreEventType"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celerity-sdk/common",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Shared runtime utilities for the Celerity Node SDK",
   "license": "Apache-2.0",
   "repository": {