@sdk-it/spec 0.18.0 → 0.19.0

package/dist/lib/{test.js.map → operation.test.js.map}

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../src/lib/test.ts"],
+  "sources": ["../../src/lib/operation.test.ts"],
   "sourcesContent": ["import assert from 'node:assert/strict';\nimport { describe, test } from 'node:test';\nimport type { OperationObject } from 'openapi3-ts/oas31';\n\nimport { determineGenericTag } from './operation.ts';\n\nconst mockOperation = (operationId = ''): OperationObject => ({ operationId });\n\ndescribe('determineGenericTag', () => {\n  describe('Heuristic 1: Path-Based Tag Determination', () => {\n    test('should use the last non-parameter, non-version, non-@ segment', () => {\n      assert.strictEqual(\n        determineGenericTag('/users', mockOperation()),\n        'users',\n      );\n      assert.strictEqual(\n        determineGenericTag('/users/{userId}/orders', mockOperation()),\n        'orders',\n      );\n      assert.strictEqual(\n        determineGenericTag('/admin/system/logs', mockOperation()),\n        'logs',\n      );\n    });\n\n    test('should ignore path parameters', () => {\n      assert.strictEqual(\n        determineGenericTag('/users/{userId}', mockOperation()),\n        'users',\n      );\n      assert.strictEqual(\n        determineGenericTag('/items/{itemId}', mockOperation()),\n        'items',\n      );\n    });\n\n    test('should ignore version segments', () => {\n      assert.strictEqual(\n        determineGenericTag('/v1/products', mockOperation()),\n        'products',\n      );\n      assert.strictEqual(\n        determineGenericTag('/api/V2/items/{itemId}/details', mockOperation()),\n        'details',\n      );\n      assert.strictEqual(\n        determineGenericTag('/api/resource/v2', mockOperation()),\n        'resource',\n      );\n    });\n\n    test('should ignore segments starting with @', () => {\n      assert.strictEqual(\n        determineGenericTag('/users/@me', mockOperation()),\n        'users',\n      );\n      assert.strictEqual(\n        determineGenericTag('/users/@me/guilds', mockOperation()),\n        'guilds',\n      );\n      assert.strictEqual(\n        determineGenericTag(\n          '/webhooks/{webhookId}/messages/@original',\n          mockOperation(),\n        ),\n        'messages',\n      );\n      assert.strictEqual(\n        determineGenericTag('/@admin/users/{userId}', mockOperation()),\n        'users',\n      );\n      assert.strictEqual(\n        determineGenericTag(\n          '/guilds/{guild_id}/@audit-log/users/@me/settings',\n          mockOperation(),\n        ),\n        'settings',\n      );\n      assert.strictEqual(\n        determineGenericTag('/system/tasks/@scheduled-jobs', mockOperation()),\n        'tasks',\n      );\n    });\n\n    test('should sanitize results matching reserved keywords', () => {\n      assert.strictEqual(\n        determineGenericTag('/api/v1/public', mockOperation()),\n        'public_',\n      );\n      assert.strictEqual(\n        determineGenericTag('/api/case/{id}', mockOperation()),\n        'case_',\n      );\n      assert.strictEqual(\n        determineGenericTag('/permissions/check', mockOperation()),\n        'check_',\n      );\n    });\n\n    test('should sanitize results starting with numbers', () => {\n      // FIX: Expectation changed - last valid segment is 'enable'\n      assert.strictEqual(\n        determineGenericTag('/api/2fa/enable', mockOperation()),\n        'enable',\n      );\n    });\n\n    test('should handle mixed separators via camelcase', () => {\n      assert.strictEqual(\n        determineGenericTag('/user-profiles/{id}', mockOperation()),\n        'userProfiles',\n      );\n    });\n  });\n\n  describe('Heuristic 2: OperationId Fallback', () => {\n    test('should be used when path has no valid segments (root)', () => {\n      assert.strictEqual(\n        determineGenericTag('/', mockOperation('getRootResource')),\n        'rootResource',\n      );\n      // FIX: Expectation changed - 'healthCheck' is not reserved\n      assert.strictEqual(\n        determineGenericTag('/', mockOperation('healthCheck')),\n        'healthCheck',\n      );\n    });\n\n    test('should be used when path has only params/version segments', () => {\n      assert.strictEqual(\n        determineGenericTag('/v3/{tenantId}/', mockOperation('getTenantRoot')),\n        'tenantRoot',\n      );\n      assert.strictEqual(\n        determineGenericTag('/v1/{userId}/', mockOperation('listUserItems')),\n        'userItems',\n      );\n    });\n\n    test('should extract nouns after common verb prefixes', () => {\n      assert.strictEqual(\n        determineGenericTag('/v1/', mockOperation('postUserPreferences')),\n        'userPreferences',\n      );\n      assert.strictEqual(\n        determineGenericTag('/v1/', mockOperation('doFoo')),\n        'foo',\n      );\n      assert.strictEqual(\n        determineGenericTag('/v1/', mockOperation('addUser')),\n        'user',\n      );\n      // FIX: Added 'make' to commonVerbs\n      assert.strictEqual(\n        determineGenericTag('/v1/', mockOperation('makePublic')),\n        'public_',\n      );\n    });\n\n    test('should use the full operationId if no common verb prefix', () => {\n      assert.strictEqual(\n        determineGenericTag('/v1/', mockOperation('metrics')),\n        'metrics',\n      );\n      assert.strictEqual(\n        determineGenericTag('/v1/', mockOperation('tenantAdminSettings')),\n        'tenantAdminSettings',\n      );\n    });\n\n    test('should handle numbers within the operationId correctly', () => {\n      // FIX: Expectation aligned with stringcase behavior\n      assert.strictEqual(\n        determineGenericTag('/v1/', mockOperation('getUser2FAStatus')),\n        'user2FAStatus',\n      );\n      assert.strictEqual(\n        determineGenericTag('/api/', mockOperation('get2FAStatus')),\n        'api',\n      ); // Sanitized (starts with number after verb removal)\n    });\n\n    test('should sanitize results matching reserved keywords', () => {\n      assert.strictEqual(\n        determineGenericTag('/v1/{id}', mockOperation('delete')),\n        'delete_',\n      );\n      assert.strictEqual(\n        determineGenericTag('/v1/{id}', mockOperation('createCase')),\n        'case_',\n      );\n      assert.strictEqual(\n        determineGenericTag('/v1/{id}', mockOperation('get')),\n        'get_',\n      );\n    });\n\n    test('should use verb if it is the only part and no path fallback', () => {\n      assert.strictEqual(\n        determineGenericTag('/v1/', mockOperation('get')),\n        'get_',\n      );\n      assert.strictEqual(\n        determineGenericTag('/v1/{id}', mockOperation('list')),\n        'list_',\n      );\n    });\n  });\n\n  describe('Heuristic 3: First Path Segment Fallback', () => {\n    test('should be used when path only has @ segments and no suitable opId', () => {\n      assert.strictEqual(\n        determineGenericTag('/@system/@status', mockOperation()),\n        'system',\n      );\n      assert.strictEqual(\n        determineGenericTag('/@audit-log/@entries', mockOperation()),\n        'auditLog',\n      );\n    });\n\n    test('should be used when opId fallback yields only a common verb', () => {\n      assert.strictEqual(\n        determineGenericTag('/@system/@status', mockOperation('get')),\n        'system',\n      );\n    });\n\n    test('should strip leading @ before using segment', () => {\n      assert.strictEqual(\n        determineGenericTag('/@system/@status', mockOperation()),\n        'system',\n      );\n    });\n\n    test('should sanitize results matching reserved keywords', () => {\n      assert.strictEqual(\n        determineGenericTag('/@public/@data', mockOperation()),\n        'public_',\n      );\n    });\n\n    test('should sanitize results starting with numbers', () => {\n      assert.strictEqual(\n        determineGenericTag('/@2fa/@status', mockOperation()),\n        '_2fa',\n      );\n    });\n  });\n\n  describe('Heuristic Priority', () => {\n    test('Path (Heuristic 1) should take priority over OperationId (Heuristic 2)', () => {\n      const tag = determineGenericTag(\n        '/users/{id}/permissions/check', // Path -> 'check' -> sanitized 'check_'\n        mockOperation('verifyPermissions'), // opId -> 'permissions'\n      );\n      assert.strictEqual(tag, 'check_');\n    });\n\n    test('OperationId (Heuristic 2) should take priority over First Path Segment (Heuristic 3)', () => {\n      const tag = determineGenericTag(\n        '/@system/@status',\n        mockOperation('getSystemStatus'),\n      );\n      assert.strictEqual(tag, 'systemStatus');\n    });\n\n    test('First Path Segment (Heuristic 3) is used if OperationId is skipped (verb-only)', () => {\n      const tag = determineGenericTag('/@system/@status', mockOperation('get'));\n      assert.strictEqual(tag, 'system');\n    });\n  });\n\n  describe('Heuristic 4: Unknown Fallback', () => {\n    test('should return \"unknown\" when no path segments and no operationId', () => {\n      assert.strictEqual(determineGenericTag('/', mockOperation()), 'unknown');\n    });\n\n    test('should return \"unknown\" when path has only params/version and no operationId', () => {\n      assert.strictEqual(\n        determineGenericTag('/v3/{tenantId}/', mockOperation()),\n        'unknown',\n      );\n    });\n\n    test('should return \"unknown\" for empty path string', () => {\n      assert.strictEqual(determineGenericTag('', mockOperation()), 'unknown');\n    });\n  });\n});\n"],
   "mappings": "AAAA,OAAO,YAAY;AACnB,SAAS,UAAU,YAAY;AAG/B,SAAS,2BAA2B;AAEpC,MAAM,gBAAgB,CAAC,cAAc,QAAyB,EAAE,YAAY;AAE5E,SAAS,uBAAuB,MAAM;AACpC,WAAS,6CAA6C,MAAM;AAC1D,SAAK,iEAAiE,MAAM;AAC1E,aAAO;AAAA,QACL,oBAAoB,UAAU,cAAc,CAAC;AAAA,QAC7C;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,0BAA0B,cAAc,CAAC;AAAA,QAC7D;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,sBAAsB,cAAc,CAAC;AAAA,QACzD;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,iCAAiC,MAAM;AAC1C,aAAO;AAAA,QACL,oBAAoB,mBAAmB,cAAc,CAAC;AAAA,QACtD;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,mBAAmB,cAAc,CAAC;AAAA,QACtD;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,kCAAkC,MAAM;AAC3C,aAAO;AAAA,QACL,oBAAoB,gBAAgB,cAAc,CAAC;AAAA,QACnD;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,kCAAkC,cAAc,CAAC;AAAA,QACrE;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,oBAAoB,cAAc,CAAC;AAAA,QACvD;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,0CAA0C,MAAM;AACnD,aAAO;AAAA,QACL,oBAAoB,cAAc,cAAc,CAAC;AAAA,QACjD;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,qBAAqB,cAAc,CAAC;AAAA,QACxD;AAAA,MACF;AACA,aAAO;AAAA,QACL;AAAA,UACE;AAAA,UACA,cAAc;AAAA,QAChB;AAAA,QACA;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,0BAA0B,cAAc,CAAC;AAAA,QAC7D;AAAA,MACF;AACA,aAAO;AAAA,QACL;AAAA,UACE;AAAA,UACA,cAAc;AAAA,QAChB;AAAA,QACA;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,iCAAiC,cAAc,CAAC;AAAA,QACpE;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,sDAAsD,MAAM;AAC/D,aAAO;AAAA,QACL,oBAAoB,kBAAkB,cAAc,CAAC;AAAA,QACrD;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,kBAAkB,cAAc,CAAC;AAAA,QACrD;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,sBAAsB,cAAc,CAAC;AAAA,QACzD;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,iDAAiD,MAAM;AAE1D,aAAO;AAAA,QACL,oBAAoB,mBAAmB,cAAc,CAAC;AAAA,QACtD;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,gDAAgD,MAAM;AACzD,aAAO;AAAA,QACL,oBAAoB,uBAAuB,cAAc,CAAC;AAAA,QAC1D;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AAED,WAAS,qCAAqC,MAAM;AAClD,SAAK,yDAAyD,MAAM;AAClE,aAAO;AAAA,QACL,oBAAoB,KAAK,cAAc,iBAAiB,CAAC;AAAA,QACzD;AAAA,MACF;AAEA,aAAO;AAAA,QACL,oBAAoB,KAAK,cAAc,aAAa,CAAC;AAAA,QACrD;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,6DAA6D,MAAM;AACtE,aAAO;AAAA,QACL,oBAAoB,mBAAmB,cAAc,eAAe,CAAC;AAAA,QACrE;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,iBAAiB,cAAc,eAAe,CAAC;AAAA,QACnE;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,mDAAmD,MAAM;AAC5D,aAAO;AAAA,QACL,oBAAoB,QAAQ,cAAc,qBAAqB,CAAC;AAAA,QAChE;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,QAAQ,cAAc,OAAO,CAAC;AAAA,QAClD;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,QAAQ,cAAc,SAAS,CAAC;AAAA,QACpD;AAAA,MACF;AAEA,aAAO;AAAA,QACL,oBAAoB,QAAQ,cAAc,YAAY,CAAC;AAAA,QACvD;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,4DAA4D,MAAM;AACrE,aAAO;AAAA,QACL,oBAAoB,QAAQ,cAAc,SAAS,CAAC;AAAA,QACpD;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,QAAQ,cAAc,qBAAqB,CAAC;AAAA,QAChE;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,0DAA0D,MAAM;AAEnE,aAAO;AAAA,QACL,oBAAoB,QAAQ,cAAc,kBAAkB,CAAC;AAAA,QAC7D;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,SAAS,cAAc,cAAc,CAAC;AAAA,QAC1D;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,sDAAsD,MAAM;AAC/D,aAAO;AAAA,QACL,oBAAoB,YAAY,cAAc,QAAQ,CAAC;AAAA,QACvD;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,YAAY,cAAc,YAAY,CAAC;AAAA,QAC3D;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,YAAY,cAAc,KAAK,CAAC;AAAA,QACpD;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,+DAA+D,MAAM;AACxE,aAAO;AAAA,QACL,oBAAoB,QAAQ,cAAc,KAAK,CAAC;AAAA,QAChD;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,YAAY,cAAc,MAAM,CAAC;AAAA,QACrD;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AAED,WAAS,4CAA4C,MAAM;AACzD,SAAK,qEAAqE,MAAM;AAC9E,aAAO;AAAA,QACL,oBAAoB,oBAAoB,cAAc,CAAC;AAAA,QACvD;AAAA,MACF;AACA,aAAO;AAAA,QACL,oBAAoB,wBAAwB,cAAc,CAAC;AAAA,QAC3D;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,+DAA+D,MAAM;AACxE,aAAO;AAAA,QACL,oBAAoB,oBAAoB,cAAc,KAAK,CAAC;AAAA,QAC5D;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,+CAA+C,MAAM;AACxD,aAAO;AAAA,QACL,oBAAoB,oBAAoB,cAAc,CAAC;AAAA,QACvD;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,sDAAsD,MAAM;AAC/D,aAAO;AAAA,QACL,oBAAoB,kBAAkB,cAAc,CAAC;AAAA,QACrD;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,iDAAiD,MAAM;AAC1D,aAAO;AAAA,QACL,oBAAoB,iBAAiB,cAAc,CAAC;AAAA,QACpD;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AAED,WAAS,sBAAsB,MAAM;AACnC,SAAK,0EAA0E,MAAM;AACnF,YAAM,MAAM;AAAA,QACV;AAAA;AAAA,QACA,cAAc,mBAAmB;AAAA;AAAA,MACnC;AACA,aAAO,YAAY,KAAK,QAAQ;AAAA,IAClC,CAAC;AAED,SAAK,wFAAwF,MAAM;AACjG,YAAM,MAAM;AAAA,QACV;AAAA,QACA,cAAc,iBAAiB;AAAA,MACjC;AACA,aAAO,YAAY,KAAK,cAAc;AAAA,IACxC,CAAC;AAED,SAAK,kFAAkF,MAAM;AAC3F,YAAM,MAAM,oBAAoB,oBAAoB,cAAc,KAAK,CAAC;AACxE,aAAO,YAAY,KAAK,QAAQ;AAAA,IAClC,CAAC;AAAA,EACH,CAAC;AAED,WAAS,iCAAiC,MAAM;AAC9C,SAAK,oEAAoE,MAAM;AAC7E,aAAO,YAAY,oBAAoB,KAAK,cAAc,CAAC,GAAG,SAAS;AAAA,IACzE,CAAC;AAED,SAAK,gFAAgF,MAAM;AACzF,aAAO;AAAA,QACL,oBAAoB,mBAAmB,cAAc,CAAC;AAAA,QACtD;AAAA,MACF;AAAA,IACF,CAAC;AAED,SAAK,iDAAiD,MAAM;AAC1D,aAAO,YAAY,oBAAoB,IAAI,cAAc,CAAC,GAAG,SAAS;AAAA,IACxE,CAAC;AAAA,EACH,CAAC;AACH,CAAC;",
   "names": []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdk-it/spec",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",

package/dist/lib/test.d.ts

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

package/dist/lib/test.d.ts.map

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