@superlayer/webhooks 1.0.67

package/dist/commonjs/__types__/typesTests.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@superlayer/core");
+const index_ts_1 = require("../index.js");
+// ---------- With a schema ----------
+const schema = core_1.i.schema({
+    entities: {
+        users: core_1.i.entity({
+            email: core_1.i.string().indexed(),
+            age: core_1.i.number().optional(),
+        }),
+    },
+});
+function _typedRecordWithSchemaCreate() {
+    const { typedHandlers } = index_ts_1.Webhooks.helpers();
+    typedHandlers('users', 'create', (record) => {
+    });
+}
+function _typedRecordWithSchemaUpdate() {
+    const { typedHandlers } = index_ts_1.Webhooks.helpers();
+    typedHandlers('users', 'update', (record) => {
+    });
+}
+function _typedRecordWithSchemaDelete() {
+    const { typedHandlers } = index_ts_1.Webhooks.helpers();
+    typedHandlers('users', 'delete', (record) => {
+    });
+}
+function _defaultHandlerWithSchema() {
+    const { typedHandlers } = index_ts_1.Webhooks.helpers();
+    typedHandlers('$default', (record) => {
+    });
+}
+// ---------- Without a schema ----------
+function _typedRecordNoSchemaCreate() {
+    // Helpers default to InstantUnknownSchema when no schema is given.
+    const { typedHandlers } = index_ts_1.Webhooks.helpers();
+    typedHandlers('$users', 'create', (record) => {
+        // Arbitrary field access is allowed under unknown schema (would error
+        // if `after` resolved to `never`).
+        const _email = record.after.email;
+    });
+}
+function _typedRecordNoSchemaUpdate() {
+    const { typedHandlers } = index_ts_1.Webhooks.helpers();
+    typedHandlers('posts', 'update', (record) => {
+    });
+}
+function _typedRecordNoSchemaDelete() {
+    const { typedHandlers } = index_ts_1.Webhooks.helpers();
+    typedHandlers('comments', 'delete', (record) => {
+    });
+}
+function _defaultHandlerNoSchema() {
+    const { typedHandlers } = index_ts_1.Webhooks.helpers();
+    typedHandlers('$default', (record) => {
+    });
+}
+// ---------- combineHandlers preserves narrowing ----------
+function _combineHandlersAcceptsTypedEntries() {
+    const { typedHandlers, combineHandlers } = index_ts_1.Webhooks.helpers();
+    const handlers = combineHandlers(typedHandlers('users', 'create', (_record) => { }), typedHandlers('users', 'update', (_record) => { }), typedHandlers('$default', (_record) => { }));
+}
+function _combineHandlersAcceptsTypedEntriesNoSchema() {
+    // Same call shape should work against an unknown schema.
+    const { typedHandlers, combineHandlers } = index_ts_1.Webhooks.helpers();
+    const handlers = combineHandlers(typedHandlers('$users', 'create', (_record) => { }), typedHandlers('$default', (_record) => { }));
+}
+// ---------- Unknown namespace is rejected when a schema is supplied ----------
+function _typedHandlersRejectsUnknownNamespaceWithSchema() {
+    const { typedHandlers } = index_ts_1.Webhooks.helpers();
+    // The schema only declares `users`. Passing a namespace not in the schema
+    // should fail typecheck.
+    // @ts-expect-error - 'posts' is not in Schema['entities']
+    typedHandlers('posts', 'create', (_record) => { });
+    // Sanity: the known namespace still typechecks.
+    typedHandlers('users', 'create', (_record) => { });
+}
+//# sourceMappingURL=typesTests.js.map

package/dist/commonjs/__types__/typesTests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typesTests.js","sourceRoot":"","sources":["../../../src/__types__/typesTests.ts"],"names":[],"mappings":"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","sourcesContent":["import { i } from '@superlayer/core';\nimport { Webhooks } from '../index.ts';\nimport type { Equal, Expect, IsAny, NotAny, NotNever } from './typeUtils.ts';\n\n// ---------- With a schema ----------\n\nconst schema = i.schema({\n  entities: {\n    users: i.entity({\n      email: i.string().indexed(),\n      age: i.number().optional(),\n    }),\n  },\n});\n\ntype Schema = typeof schema;\n\nfunction _typedRecordWithSchemaCreate() {\n  const { typedHandlers } = Webhooks.helpers<Schema>();\n  typedHandlers('users', 'create', (record) => {\n    type Namespace = typeof record.namespace;\n    type Action = typeof record.action;\n    type Before = typeof record.before;\n    type After = typeof record.after;\n\n    type _cases = [\n      Expect<NotAny<typeof record>>,\n      Expect<Equal<Namespace, 'users'>>,\n      Expect<Equal<Action, 'create'>>,\n      Expect<Equal<Before, null>>,\n      Expect<NotAny<After>>,\n      // The entity has id + the schema attrs.\n      Expect<Equal<After['id'], string>>,\n      Expect<Equal<After['email'], string>>,\n      Expect<Equal<After['age'], number | undefined>>,\n    ];\n  });\n}\n\nfunction _typedRecordWithSchemaUpdate() {\n  const { typedHandlers } = Webhooks.helpers<Schema>();\n  typedHandlers('users', 'update', (record) => {\n    type Before = typeof record.before;\n    type After = typeof record.after;\n    type _cases = [\n      Expect<Equal<typeof record.namespace, 'users'>>,\n      Expect<Equal<typeof record.action, 'update'>>,\n      // Both before and after are present for updates.\n      Expect<Equal<Before['id'], string>>,\n      Expect<Equal<After['id'], string>>,\n      Expect<Equal<Before['email'], string>>,\n      Expect<Equal<After['email'], string>>,\n    ];\n  });\n}\n\nfunction _typedRecordWithSchemaDelete() {\n  const { typedHandlers } = Webhooks.helpers<Schema>();\n  typedHandlers('users', 'delete', (record) => {\n    type _cases = [\n      Expect<Equal<typeof record.namespace, 'users'>>,\n      Expect<Equal<typeof record.action, 'delete'>>,\n      // `after` is null for deletes; `before` carries the entity.\n      Expect<Equal<typeof record.after, null>>,\n      Expect<Equal<typeof record.before.id, string>>,\n      Expect<Equal<typeof record.before.email, string>>,\n    ];\n  });\n}\n\nfunction _defaultHandlerWithSchema() {\n  const { typedHandlers } = Webhooks.helpers<Schema>();\n  typedHandlers('$default', (record) => {\n    type Namespace = typeof record.namespace;\n    type Action = typeof record.action;\n    type _cases = [\n      // The $default form spans all namespaces and actions in the schema.\n      Expect<Equal<Namespace, 'users'>>,\n      Expect<Equal<Action, 'create' | 'update' | 'delete'>>,\n    ];\n  });\n}\n\n// ---------- Without a schema ----------\n\nfunction _typedRecordNoSchemaCreate() {\n  // Helpers default to InstantUnknownSchema when no schema is given.\n  const { typedHandlers } = Webhooks.helpers();\n  typedHandlers('$users', 'create', (record) => {\n    type Namespace = typeof record.namespace;\n    type Action = typeof record.action;\n    type After = typeof record.after;\n    type _cases = [\n      Expect<NotAny<typeof record>>,\n      Expect<NotNever<typeof record>>,\n      // The literal namespace passed at the call site is preserved even without\n      // a schema — this is the regression we just fixed.\n      Expect<Equal<Namespace, '$users'>>,\n      Expect<Equal<Action, 'create'>>,\n      Expect<Equal<typeof record.before, null>>,\n      // `after` is an entity reachable without a schema (the regression we\n      // fixed). With unknown attrs, individual fields fall through to `any`\n      // via the index signature, so we just check the shape is usable.\n      Expect<NotNever<After>>,\n      Expect<NotNever<After['id']>>,\n    ];\n    // Arbitrary field access is allowed under unknown schema (would error\n    // if `after` resolved to `never`).\n    const _email: unknown = record.after.email;\n  });\n}\n\nfunction _typedRecordNoSchemaUpdate() {\n  const { typedHandlers } = Webhooks.helpers();\n  typedHandlers('posts', 'update', (record) => {\n    type _cases = [\n      Expect<Equal<typeof record.namespace, 'posts'>>,\n      Expect<Equal<typeof record.action, 'update'>>,\n      Expect<NotNever<typeof record.before>>,\n      Expect<NotNever<typeof record.after>>,\n    ];\n  });\n}\n\nfunction _typedRecordNoSchemaDelete() {\n  const { typedHandlers } = Webhooks.helpers();\n  typedHandlers('comments', 'delete', (record) => {\n    type _cases = [\n      Expect<Equal<typeof record.namespace, 'comments'>>,\n      Expect<Equal<typeof record.action, 'delete'>>,\n      Expect<Equal<typeof record.after, null>>,\n      Expect<NotNever<typeof record.before>>,\n    ];\n  });\n}\n\nfunction _defaultHandlerNoSchema() {\n  const { typedHandlers } = Webhooks.helpers();\n  typedHandlers('$default', (record) => {\n    type Namespace = typeof record.namespace;\n    type Action = typeof record.action;\n    type _cases = [\n      // Without a schema, namespace is exactly `string` — not `string | number`\n      // (which would leak the TS index-signature `keyof` artifact, since\n      // namespaces are always strings on the wire).\n      Expect<Equal<Namespace, string>>,\n      Expect<Equal<Action, 'create' | 'update' | 'delete'>>,\n    ];\n  });\n}\n\n// ---------- combineHandlers preserves narrowing ----------\n\nfunction _combineHandlersAcceptsTypedEntries() {\n  const { typedHandlers, combineHandlers } = Webhooks.helpers<Schema>();\n  const handlers = combineHandlers(\n    typedHandlers('users', 'create', (_record) => {}),\n    typedHandlers('users', 'update', (_record) => {}),\n    typedHandlers('$default', (_record) => {}),\n  );\n  type _cases = [Expect<NotAny<typeof handlers>>];\n}\n\nfunction _combineHandlersAcceptsTypedEntriesNoSchema() {\n  // Same call shape should work against an unknown schema.\n  const { typedHandlers, combineHandlers } = Webhooks.helpers();\n  const handlers = combineHandlers(\n    typedHandlers('$users', 'create', (_record) => {}),\n    typedHandlers('$default', (_record) => {}),\n  );\n  type _cases = [Expect<NotAny<typeof handlers>>];\n}\n\n// ---------- Unknown namespace is rejected when a schema is supplied ----------\n\nfunction _typedHandlersRejectsUnknownNamespaceWithSchema() {\n  const { typedHandlers } = Webhooks.helpers<Schema>();\n  // The schema only declares `users`. Passing a namespace not in the schema\n  // should fail typecheck.\n  // @ts-expect-error - 'posts' is not in Schema['entities']\n  typedHandlers('posts', 'create', (_record) => {});\n\n  // Sanity: the known namespace still typechecks.\n  typedHandlers('users', 'create', (_record) => {});\n}\n\n// Silence unused-symbol warnings for the test cases.\ntype _silence = IsAny<unknown>;\n"]}