authfn 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -54,8 +54,7 @@ const auth = createAuthFn({
54
54
  namespace: 'authfn',
55
55
  enableApi: true,
56
56
  apiConfig: {
57
- basePath: '/auth',
58
- adminKey: process.env.ADMIN_KEY,
57
+ adminKey: process.env.ADMIN_KEY, // Optional: protect management API
59
58
  },
60
59
  });
61
60
  ```
@@ -79,15 +78,15 @@ Mount both the auth management API and your library's API:
79
78
 
80
79
  ```typescript
81
80
  import express from 'express';
82
- import { toExpressRouter } from '@superfunctions/http-express';
81
+ import { toExpress } from '@superfunctions/http-express';
83
82
 
84
83
  const app = express();
85
84
 
86
85
  // Mount auth management API
87
- app.use('/api/auth', toExpressRouter(auth.router));
86
+ app.use('/api/auth', toExpress(auth.router));
88
87
 
89
88
  // Mount your library's API
90
- app.use('/api/conduct', toExpressRouter(conduct.router));
89
+ app.use('/api/conduct', toExpress(conduct.router));
91
90
 
92
91
  app.listen(3000);
93
92
  ```
@@ -0,0 +1,11 @@
1
+ /**
2
+ * authfn - API key authentication using Superfunctions abstractions
3
+ */
4
+ import type { AuthFnConfig, AuthFnInstance } from './types.js';
5
+ /**
6
+ * Create authfn instance
7
+ */
8
+ export declare function createAuthFn(config: AuthFnConfig): AuthFnInstance;
9
+ export type { AuthFnConfig, AuthFnInstance, ApiKey, ApiKeySession } from './types.js';
10
+ export { getSchema } from './schema.js';
11
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAyB,MAAM,YAAY,CAAC;AAsBtF;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CA+PjE;AAGD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,241 @@
1
+ /**
2
+ * authfn - API key authentication using Superfunctions abstractions
3
+ */
4
+ import { InvalidCredentialsError, ExpiredCredentialsError } from '@superfunctions/auth';
5
+ import { createRouter } from '@superfunctions/http';
6
+ import { UnauthorizedError, NotFoundError } from '@superfunctions/http';
7
+ /**
8
+ * Generate a secure API key
9
+ */
10
+ function generateApiKey(prefix = 'ak') {
11
+ const randomBytes = crypto.getRandomValues(new Uint8Array(32));
12
+ const key = Array.from(randomBytes)
13
+ .map(b => b.toString(16).padStart(2, '0'))
14
+ .join('');
15
+ return `${prefix}_${key}`;
16
+ }
17
+ /**
18
+ * Generate unique ID
19
+ */
20
+ function generateId(prefix) {
21
+ const timestamp = Date.now().toString(36);
22
+ const random = Math.random().toString(36).substring(2, 9);
23
+ return `${prefix}_${timestamp}${random}`;
24
+ }
25
+ /**
26
+ * Create authfn instance
27
+ */
28
+ export function createAuthFn(config) {
29
+ const { database, namespace = 'authfn', enableApi = false, apiConfig } = config;
30
+ // Auth provider implementation
31
+ const provider = {
32
+ async authenticate(request) {
33
+ const authHeader = request.headers.get('authorization');
34
+ if (!authHeader) {
35
+ return null;
36
+ }
37
+ const token = authHeader.replace(/^Bearer\s+/i, '');
38
+ if (!token) {
39
+ return null;
40
+ }
41
+ // Look up API key in database
42
+ const apiKey = await database.findOne({
43
+ model: 'apiKeys',
44
+ where: [
45
+ { field: 'key', operator: 'eq', value: token },
46
+ ],
47
+ namespace,
48
+ });
49
+ if (!apiKey) {
50
+ throw new InvalidCredentialsError('Invalid API key');
51
+ }
52
+ // Check if revoked
53
+ if (apiKey.revokedAt) {
54
+ throw new InvalidCredentialsError('API key has been revoked');
55
+ }
56
+ // Check if expired
57
+ if (apiKey.expiresAt) {
58
+ const expiresAt = new Date(apiKey.expiresAt);
59
+ if (expiresAt < new Date()) {
60
+ throw new ExpiredCredentialsError('API key has expired');
61
+ }
62
+ }
63
+ // Update last used timestamp
64
+ await database.update({
65
+ model: 'apiKeys',
66
+ where: [{ field: 'id', operator: 'eq', value: apiKey.id }],
67
+ data: { lastUsedAt: new Date().toISOString() },
68
+ namespace,
69
+ });
70
+ return {
71
+ id: apiKey.id,
72
+ type: 'api-key',
73
+ keyId: apiKey.id,
74
+ name: apiKey.name,
75
+ resourceIds: apiKey.resourceIds,
76
+ scopes: apiKey.scopes,
77
+ expiresAt: apiKey.expiresAt ? new Date(apiKey.expiresAt) : undefined,
78
+ metadata: apiKey.metadata,
79
+ };
80
+ },
81
+ async authorize(session, resourceId) {
82
+ return session.resourceIds.includes(resourceId);
83
+ },
84
+ async revoke(sessionId) {
85
+ await database.update({
86
+ model: 'apiKeys',
87
+ where: [{ field: 'id', operator: 'eq', value: sessionId }],
88
+ data: { revokedAt: new Date().toISOString() },
89
+ namespace,
90
+ });
91
+ },
92
+ };
93
+ // Key management functions
94
+ async function createKey(data) {
95
+ const id = generateId('key');
96
+ const key = generateApiKey('ak');
97
+ await database.create({
98
+ model: 'apiKeys',
99
+ data: {
100
+ id,
101
+ key,
102
+ name: data.name,
103
+ resourceIds: data.resourceIds,
104
+ scopes: data.scopes || null,
105
+ metadata: data.metadata || null,
106
+ expiresAt: data.expiresAt ? data.expiresAt.toISOString() : null,
107
+ lastUsedAt: null,
108
+ revokedAt: null,
109
+ createdAt: new Date().toISOString(),
110
+ },
111
+ namespace,
112
+ });
113
+ return { id, key };
114
+ }
115
+ async function revokeKey(keyId) {
116
+ await database.update({
117
+ model: 'apiKeys',
118
+ where: [{ field: 'id', operator: 'eq', value: keyId }],
119
+ data: { revokedAt: new Date().toISOString() },
120
+ namespace,
121
+ });
122
+ }
123
+ async function getKey(keyId) {
124
+ const key = await database.findOne({
125
+ model: 'apiKeys',
126
+ where: [{ field: 'id', operator: 'eq', value: keyId }],
127
+ namespace,
128
+ });
129
+ return key;
130
+ }
131
+ async function listKeys(filters) {
132
+ const where = [];
133
+ if (filters?.resourceId) {
134
+ where.push({ field: 'resourceIds', operator: 'contains', value: filters.resourceId });
135
+ }
136
+ const keys = await database.findMany({
137
+ model: 'apiKeys',
138
+ where,
139
+ orderBy: [{ field: 'createdAt', direction: 'desc' }],
140
+ namespace,
141
+ });
142
+ return keys;
143
+ }
144
+ // Create management API router if enabled
145
+ let router;
146
+ if (enableApi) {
147
+ const adminKey = apiConfig?.adminKey;
148
+ // Admin auth middleware
149
+ const adminAuthMiddleware = async (req, _ctx, next) => {
150
+ if (!adminKey) {
151
+ return next(); // No admin key configured, skip auth
152
+ }
153
+ const authHeader = req.headers.get('authorization');
154
+ const token = authHeader?.replace(/^Bearer\s+/i, '');
155
+ if (token !== adminKey) {
156
+ throw new UnauthorizedError('Invalid admin key');
157
+ }
158
+ return next();
159
+ };
160
+ router = createRouter({
161
+ middleware: [adminAuthMiddleware],
162
+ routes: [
163
+ // POST /keys - Create API key
164
+ {
165
+ method: 'POST',
166
+ path: '/keys',
167
+ handler: async (_req, ctx) => {
168
+ const body = await ctx.json();
169
+ const result = await createKey({
170
+ name: body.name,
171
+ resourceIds: body.resourceIds,
172
+ scopes: body.scopes,
173
+ metadata: body.metadata,
174
+ expiresAt: body.expiresAt ? new Date(body.expiresAt) : undefined,
175
+ });
176
+ return Response.json(result, { status: 201 });
177
+ },
178
+ },
179
+ // GET /keys - List API keys
180
+ {
181
+ method: 'GET',
182
+ path: '/keys',
183
+ handler: async (_req, ctx) => {
184
+ const resourceId = ctx.query.get('resourceId') || undefined;
185
+ const keys = await listKeys({ resourceId });
186
+ // Don't return the actual key values
187
+ const sanitized = keys.map(k => ({
188
+ id: k.id,
189
+ name: k.name,
190
+ resourceIds: k.resourceIds,
191
+ scopes: k.scopes,
192
+ metadata: k.metadata,
193
+ expiresAt: k.expiresAt,
194
+ lastUsedAt: k.lastUsedAt,
195
+ revokedAt: k.revokedAt,
196
+ createdAt: k.createdAt,
197
+ }));
198
+ return Response.json({ keys: sanitized });
199
+ },
200
+ },
201
+ // GET /keys/:id - Get API key
202
+ {
203
+ method: 'GET',
204
+ path: '/keys/:id',
205
+ handler: async (_req, ctx) => {
206
+ const key = await getKey(ctx.params.id);
207
+ if (!key) {
208
+ throw new NotFoundError('API key not found');
209
+ }
210
+ // Don't return the actual key value
211
+ const { key: _, ...sanitized } = key;
212
+ return Response.json(sanitized);
213
+ },
214
+ },
215
+ // DELETE /keys/:id - Revoke API key
216
+ {
217
+ method: 'DELETE',
218
+ path: '/keys/:id',
219
+ handler: async (_req, ctx) => {
220
+ await revokeKey(ctx.params.id);
221
+ return Response.json({ success: true });
222
+ },
223
+ },
224
+ ],
225
+ });
226
+ }
227
+ return {
228
+ provider: {
229
+ authenticate: provider.authenticate.bind(provider),
230
+ authorize: provider.authorize.bind(provider),
231
+ revoke: provider.revoke.bind(provider),
232
+ },
233
+ router,
234
+ createKey,
235
+ revokeKey,
236
+ getKey,
237
+ listKeys,
238
+ };
239
+ }
240
+ export { getSchema } from './schema.js';
241
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Schema definition for authfn
3
+ * Used by @superfunctions/cli to generate migrations
4
+ */
5
+ import type { TableSchema } from '@superfunctions/db';
6
+ export declare function getSchema(config?: {
7
+ namespace?: string;
8
+ }): {
9
+ version: number;
10
+ schemas: TableSchema[];
11
+ };
12
+ //# sourceMappingURL=schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB,CAwEA"}
package/dist/schema.js ADDED
@@ -0,0 +1,77 @@
1
+ /**
2
+ * Schema definition for authfn
3
+ * Used by @superfunctions/cli to generate migrations
4
+ */
5
+ export function getSchema(config) {
6
+ const namespace = config?.namespace || 'authfn';
7
+ return {
8
+ version: 1,
9
+ schemas: [
10
+ // API Keys table
11
+ {
12
+ modelName: 'apiKeys',
13
+ fields: {
14
+ id: {
15
+ type: 'string',
16
+ required: true,
17
+ fieldName: 'id',
18
+ },
19
+ key: {
20
+ type: 'string',
21
+ required: true,
22
+ unique: true,
23
+ fieldName: 'key',
24
+ },
25
+ name: {
26
+ type: 'string',
27
+ required: true,
28
+ fieldName: 'name',
29
+ },
30
+ resourceIds: {
31
+ type: 'json',
32
+ required: true,
33
+ fieldName: 'resource_ids',
34
+ },
35
+ scopes: {
36
+ type: 'json',
37
+ required: false,
38
+ fieldName: 'scopes',
39
+ },
40
+ metadata: {
41
+ type: 'json',
42
+ required: false,
43
+ fieldName: 'metadata',
44
+ },
45
+ expiresAt: {
46
+ type: 'date',
47
+ required: false,
48
+ fieldName: 'expires_at',
49
+ },
50
+ lastUsedAt: {
51
+ type: 'date',
52
+ required: false,
53
+ fieldName: 'last_used_at',
54
+ },
55
+ revokedAt: {
56
+ type: 'date',
57
+ required: false,
58
+ fieldName: 'revoked_at',
59
+ },
60
+ createdAt: {
61
+ type: 'date',
62
+ required: true,
63
+ fieldName: 'created_at',
64
+ },
65
+ },
66
+ indexes: [
67
+ {
68
+ name: `idx_${namespace}_api_keys_key`,
69
+ fields: ['key'],
70
+ unique: true,
71
+ },
72
+ ],
73
+ },
74
+ ],
75
+ };
76
+ }
77
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,UAAU,SAAS,CAAC,MAA+B;IAIvD,MAAM,SAAS,GAAG,MAAM,EAAE,SAAS,IAAI,QAAQ,CAAC;IAEhD,OAAO;QACL,OAAO,EAAE,CAAC;QACV,OAAO,EAAE;YACP,iBAAiB;YACjB;gBACE,SAAS,EAAE,SAAS;gBACpB,MAAM,EAAE;oBACN,EAAE,EAAE;wBACF,IAAI,EAAE,QAAQ;wBACd,QAAQ,EAAE,IAAI;wBACd,SAAS,EAAE,IAAI;qBAChB;oBACD,GAAG,EAAE;wBACH,IAAI,EAAE,QAAQ;wBACd,QAAQ,EAAE,IAAI;wBACd,MAAM,EAAE,IAAI;wBACZ,SAAS,EAAE,KAAK;qBACjB;oBACD,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,QAAQ,EAAE,IAAI;wBACd,SAAS,EAAE,MAAM;qBAClB;oBACD,WAAW,EAAE;wBACX,IAAI,EAAE,MAAM;wBACZ,QAAQ,EAAE,IAAI;wBACd,SAAS,EAAE,cAAc;qBAC1B;oBACD,MAAM,EAAE;wBACN,IAAI,EAAE,MAAM;wBACZ,QAAQ,EAAE,KAAK;wBACf,SAAS,EAAE,QAAQ;qBACpB;oBACD,QAAQ,EAAE;wBACR,IAAI,EAAE,MAAM;wBACZ,QAAQ,EAAE,KAAK;wBACf,SAAS,EAAE,UAAU;qBACtB;oBACD,SAAS,EAAE;wBACT,IAAI,EAAE,MAAM;wBACZ,QAAQ,EAAE,KAAK;wBACf,SAAS,EAAE,YAAY;qBACxB;oBACD,UAAU,EAAE;wBACV,IAAI,EAAE,MAAM;wBACZ,QAAQ,EAAE,KAAK;wBACf,SAAS,EAAE,cAAc;qBAC1B;oBACD,SAAS,EAAE;wBACT,IAAI,EAAE,MAAM;wBACZ,QAAQ,EAAE,KAAK;wBACf,SAAS,EAAE,YAAY;qBACxB;oBACD,SAAS,EAAE;wBACT,IAAI,EAAE,MAAM;wBACZ,QAAQ,EAAE,IAAI;wBACd,SAAS,EAAE,YAAY;qBACxB;iBACF;gBACD,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,OAAO,SAAS,eAAe;wBACrC,MAAM,EAAE,CAAC,KAAK,CAAC;wBACf,MAAM,EAAE,IAAI;qBACb;iBACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,80 @@
1
+ /**
2
+ * Types for authfn
3
+ */
4
+ import type { AuthSession } from '@superfunctions/auth';
5
+ import type { Adapter } from '@superfunctions/db';
6
+ import type { Router } from '@superfunctions/http';
7
+ /**
8
+ * API key session extends base AuthSession
9
+ */
10
+ export interface ApiKeySession extends AuthSession {
11
+ type: 'api-key';
12
+ keyId: string;
13
+ name: string;
14
+ }
15
+ /**
16
+ * API key data stored in database
17
+ */
18
+ export interface ApiKey {
19
+ id: string;
20
+ key: string;
21
+ name: string;
22
+ resourceIds: string[];
23
+ scopes?: string[];
24
+ metadata?: Record<string, any>;
25
+ expiresAt?: Date | string;
26
+ lastUsedAt?: Date | string;
27
+ revokedAt?: Date | string;
28
+ createdAt: Date | string;
29
+ }
30
+ /**
31
+ * Configuration for authfn
32
+ */
33
+ export interface AuthFnConfig {
34
+ /** Database adapter */
35
+ database: Adapter;
36
+ /** Namespace for table prefixing (default: 'authfn') */
37
+ namespace?: string;
38
+ /** Mount management API (default: false) */
39
+ enableApi?: boolean;
40
+ /** API configuration (required if enableApi is true) */
41
+ apiConfig?: {
42
+ /** Base path for API routes (default: '/auth') */
43
+ basePath?: string;
44
+ /** Admin API key for managing keys (optional) */
45
+ adminKey?: string;
46
+ };
47
+ }
48
+ /**
49
+ * AuthFn instance with provider and optional router
50
+ */
51
+ export interface AuthFnInstance {
52
+ /** Auth provider for use with other libraries */
53
+ provider: {
54
+ authenticate: (request: Request) => Promise<ApiKeySession | null>;
55
+ authorize: (session: ApiKeySession, resourceId: string) => Promise<boolean>;
56
+ revoke: (sessionId: string) => Promise<void>;
57
+ };
58
+ /** Management API router (if enabled) */
59
+ router?: Router;
60
+ /** Create a new API key */
61
+ createKey: (data: {
62
+ name: string;
63
+ resourceIds: string[];
64
+ scopes?: string[];
65
+ metadata?: Record<string, any>;
66
+ expiresAt?: Date;
67
+ }) => Promise<{
68
+ id: string;
69
+ key: string;
70
+ }>;
71
+ /** Revoke an API key */
72
+ revokeKey: (keyId: string) => Promise<void>;
73
+ /** Get API key by ID */
74
+ getKey: (keyId: string) => Promise<ApiKey | null>;
75
+ /** List API keys */
76
+ listKeys: (filters?: {
77
+ resourceId?: string;
78
+ }) => Promise<ApiKey[]>;
79
+ }
80
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC1B,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,QAAQ,EAAE,OAAO,CAAC;IAElB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,wDAAwD;IACxD,SAAS,CAAC,EAAE;QACV,kDAAkD;QAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,iDAAiD;QACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,QAAQ,EAAE;QACR,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;QAClE,SAAS,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5E,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC9C,CAAC;IAEF,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,2BAA2B;IAC3B,SAAS,EAAE,CAAC,IAAI,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC/B,SAAS,CAAC,EAAE,IAAI,CAAC;KAClB,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE3C,wBAAwB;IACxB,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C,wBAAwB;IACxB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAElD,oBAAoB;IACpB,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACpE"}
package/dist/types.js ADDED
@@ -0,0 +1,5 @@
1
+ /**
2
+ * Types for authfn
3
+ */
4
+ export {};
5
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "authfn",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Authentication self deployed",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -41,10 +41,15 @@
41
41
  "publishConfig": {
42
42
  "access": "public"
43
43
  },
44
+ "superfunctions": {
45
+ "initFunction": "createAuthFn",
46
+ "schemaVersion": 1,
47
+ "namespace": "authfn"
48
+ },
44
49
  "dependencies": {
45
- "@superfunctions/auth": "workspace:*",
46
- "@superfunctions/db": "workspace:*",
47
- "@superfunctions/http": "workspace:*"
50
+ "@superfunctions/auth": "*",
51
+ "@superfunctions/db": "*",
52
+ "@superfunctions/http": "*"
48
53
  },
49
54
  "devDependencies": {
50
55
  "@types/node": "^22.0.0",